Skip to content

chore(flags): docs on the new sendFeatureFlags (or send_feature_flags) behavior#12187

Merged
dmarticus merged 14 commits intomasterfrom
chore/docs-on-send-feature-flags
Jul 23, 2025
Merged

chore(flags): docs on the new sendFeatureFlags (or send_feature_flags) behavior#12187
dmarticus merged 14 commits intomasterfrom
chore/docs-on-send-feature-flags

Conversation

@dmarticus
Copy link
Copy Markdown
Contributor

@dmarticus dmarticus commented Jul 15, 2025

Changes

Docs for these changes:

Checklist

  • Words are spelled using American English
  • Titles are in sentence case
  • Feature names are in sentence case too
  • Use relative URLs for internal links
  • If I moved a page, I added a redirect in vercel.json

@vercel
Copy link
Copy Markdown

vercel Bot commented Jul 15, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
posthog 🛑 Canceled (Inspect) Jul 22, 2025 10:42pm

Copy link
Copy Markdown
Contributor

@ivanagas ivanagas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think there is some tweaks here we can do to make this a lot clearer.


## Performance considerations

- **With local evaluation**: When [local evaluation](/docs/feature-flags/local-evaluation) is configured, setting `sendFeatureFlags: true` will **not** make additional server requests. Instead, it uses the locally cached feature flags, and it provides an interface for including person and/or group properties needed to evaluate the flags in the context of the event, if required.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm a bit confused here.

If you are using local evaluation, you also need to set onlyEvaluateLocally: true when calling capture with sendFeatureFlags? Person and group properties for sendFeatureFlags are only relevant if locally evaluating?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ahh, I guess if you want sendFeatureFlags to evaluate locally too you use it, otherwise it will make a server-call?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Person and group properties for sendFeatureFlags are only relevant if locally evaluating?

Not true, we still support property overrides even when we use the server call (e.g. they want to pass a person property that hasn't been ingested yet)

If you are using local evaluation, you also need to set onlyEvaluateLocally: true when calling capture with sendFeatureFlags?

yeah, the idea is you have to specify that you're sending feature flags locally, otherwise we will hit the servers for the most up-to-date evaluation.

dmarticus and others added 13 commits July 22, 2025 15:12
…lags-code-python-set-send-feature-flags-to-true.mdx

Co-authored-by: Ian Vanagas <34755028+ivanagas@users.noreply.github.com>
…lags-code-python-set-send-feature-flags-to-true.mdx

Co-authored-by: Ian Vanagas <34755028+ivanagas@users.noreply.github.com>
…lags-code-python-set-send-feature-flags-to-true.mdx

Co-authored-by: Ian Vanagas <34755028+ivanagas@users.noreply.github.com>
…lags-code-node-set-send-feature-flags-to-true.mdx

Co-authored-by: Ian Vanagas <34755028+ivanagas@users.noreply.github.com>
…lags-code-node-set-send-feature-flags-to-true.mdx

Co-authored-by: Ian Vanagas <34755028+ivanagas@users.noreply.github.com>
…lags-code-node-set-send-feature-flags-to-true.mdx

Co-authored-by: Ian Vanagas <34755028+ivanagas@users.noreply.github.com>
…lags-code-node-set-send-feature-flags-to-true.mdx

Co-authored-by: Ian Vanagas <34755028+ivanagas@users.noreply.github.com>
…lags-code-python-set-send-feature-flags-to-true.mdx

Co-authored-by: Ian Vanagas <34755028+ivanagas@users.noreply.github.com>
…lags-code-node-set-send-feature-flags-to-true.mdx

Co-authored-by: Ian Vanagas <34755028+ivanagas@users.noreply.github.com>
…/posthog.com into chore/docs-on-send-feature-flags
Copy link
Copy Markdown
Contributor

@ivanagas ivanagas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks great, thanks!

@dmarticus dmarticus merged commit 4dabb0c into master Jul 23, 2025
7 checks passed
@dmarticus dmarticus deleted the chore/docs-on-send-feature-flags branch July 23, 2025 05:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants