posthog
7.18.0 — 2026-06-05
Minor changes
- a2ce51e feat(feature-flags): support the
early_exit condition option in local evaluation. When a flag enables early exit, evaluation now stops and returns False as soon as a condition group's property filters match but the rollout percentage excludes the user, instead of falling through to later groups — matching the server-side evaluation behavior. — Thanks @gustavohstrassburger!
7.17.0 — 2026-06-03
Minor changes
- 3aed638 Add a configurable
$is_server event property (default true) so PostHog can identify server-side events. Set is_server=False when using posthog-python as a client/CLI so the device OS is attributed normally. — Thanks @turnipdabeets for your first contribution 🎉!
7.16.4 — 2026-06-03
Patch changes
- 44e6b14 Fix async streaming responses from the AI wrappers (OpenAI, Anthropic, Gemini) so they support
async with as well as async for. Previously, consuming a stream via async with (e.g. with pydantic-ai) raised TypeError: 'async_generator' object does not support the asynchronous context manager protocol. — Thanks @turnipdabeets for your first contribution 🎉!
7.16.3 — 2026-06-01
Patch changes
- 643a810 Return empty flag defaults from Client flag helpers when the flags API fails. — Thanks @marandaneto!
7.16.2 — 2026-05-28
Patch changes
7.16.1 — 2026-05-27
Patch changes
- 8f6d6c8 Include group context in the
$feature_flag_called dedupe key so group-scoped flags fire a separate event for each group a user is evaluated under, instead of being dedup-ed against the first group context the same (distinct_id, flag, response) was seen under. — Thanks @gustavohstrassburger!
7.16.0 — 2026-05-27
Minor changes
7.15.4 — 2026-05-25
Patch changes
7.15.3 — 2026-05-21
Patch changes
- be9b78b Reject semver values with leading zeros in local flag evaluation. Per semver 2.0.0 §2, numeric identifiers must not include leading zeros — values like
1.07.3 are not valid semver and should not match targeting conditions. Both override values and flag values are now validated; invalid inputs raise InconclusiveMatchError so the condition does not match. — Thanks @dmarticus!
7.15.2 — 2026-05-21
Patch changes
7.15.1 — 2026-05-21
Patch changes
- a098aa7 Fix Gemini web search extraction when response candidates are null. — Thanks @marandaneto!
7.15.0 — 2026-05-19
Minor changes
7.14.2 — 2026-05-13
Patch changes
7.14.1 — 2026-05-11
Patch changes
- f6c8ede fix: type warning on new_context — Thanks @itsaphel for your first contribution 🎉!
7.14.0 — 2026-05-01
Minor changes
-
69dc2a8 Add evaluate_flags() and a new flags option on capture() so a single /flags call can power both flag branching and event enrichment per request:
flags = posthog.evaluate_flags(distinct_id, person_properties={"plan": "enterprise"})
if flags.is_enabled("new-dashboard"):
render_new_dashboard()
posthog.capture("page_viewed", distinct_id=distinct_id, flags=flags)
The returned FeatureFlagEvaluations snapshot exposes is_enabled(), get_flag(), get_flag_payload() for branching and only_accessed() / only([keys]) filter helpers. Pass flag_keys=[...] to evaluate_flags() to scope the underlying /flags request itself.
Deprecates feature_enabled(), get_feature_flag(), get_feature_flag_payload(), and capture(send_feature_flags=...). They continue to work but now emit a DeprecationWarning pointing at evaluate_flags(). Removal is planned for the next major version. — Thanks @dmarticus!
7.13.2 — 2026-04-30
Patch changes
7.13.1 — 2026-04-24
Patch changes
7.13.0 — 2026-04-21
Minor changes
- 12c38e7 Add
capture_errors option to Prompts that reports prompt fetch failures to PostHog error tracking via capture_exception() when enabled. — Thanks @andrewm4894!
Patch changes
- 1b098e7 Trim surrounding whitespace from API keys and host config before using them. — Thanks @marandaneto!
7.12.0 — 2026-04-16
Minor changes
- 220d9e8
Prompts.get() now accepts with_metadata=True and returns a PromptResult dataclass containing source (api, cache, stale_cache, or code_fallback), name, and version alongside the prompt text. The previous plain-string return is deprecated and will be removed in a future major version. — Thanks @marandaneto!
7.11.2 — 2026-04-15
Patch changes
- f5a95b4 feat(flags): switch local evaluation polling from
/api/feature_flag/local_evaluation to /flags/definitions — Thanks @patricio-posthog!
7.11.1 — 2026-04-14
Patch changes
7.11.0 — 2026-04-10
Minor changes
Patch changes
- 7c5cad8 fix: graceful fallback in claude_agent_sdk query wrapper when PostHog is not configured — Thanks @andrewm4894!
7.10.3 — 2026-04-08
Patch changes
- e22e893 fix: pass the module-level
posthog.before_send callback into the lazily initialized default client — Thanks @marandaneto!
7.10.2 — 2026-04-08
Patch changes
- bae355c feat(flags): make local evaluation endpoint configurable via
POSTHOG_LOCAL_EVALUATION_ENDPOINT env var with fallback to default endpoint — Thanks @patricio-posthog for your first contribution 🎉!
7.10.1 — 2026-04-08
Patch changes
- a5052b0 fix: Django middleware accidentally passed capture_exceptions as positional arg, setting fresh=True and resetting context state — Thanks @marandaneto!
7.10.0 — 2026-04-07
Minor changes
Patch changes
- 754c45f fix: propagate missing params in module-level wrapper functions (
distinct_id for group_identify, flag_keys_to_evaluate for get_all_flags/get_all_flags_and_payloads) — Thanks @dustinbyrne!
7.9.12 — 2026-03-12
Patch changes
- 1729be4 chore(flags): expose flag_definition_cache_provider — Thanks @matheus-vb for your first contribution 🎉!
7.9.11 — 2026-03-11
Patch changes
7.9.10 — 2026-03-10
Patch changes
7.9.9 — 2026-03-10
Patch changes
7.9.8 — 2026-03-09
Patch changes
7.9.7 — 2026-03-05
Patch changes
- b206669 fix(llma): use distinct_id from outer context if not provided, fix $process_person_profile for context-based identity — Thanks @ethanporcaro for your first contribution 🎉!
- a99c7d7 Add warning log for local flag evaluation cold start — Thanks @dmarticus!
7.9.6 — 2026-03-02
Patch changes
7.9.5 — 2026-03-02
Patch changes
7.9.4 — 2026-02-25
Patch changes
- a68a6a6 feat(llma): add
$ai_tokens_source property ("sdk" or "passthrough") to all $ai_generation events to detect when token values are externally overridden via posthog_properties — Thanks @carlos-marchal-ph!
7.9.3 — 2026-02-18
Patch changes
7.9.2 — 2026-02-18
Patch changes
7.9.1 - 2026-02-17
fix(llma): make prompt fetches deterministic by requiring project_api_key and sending it as token query param
7.9.0 - 2026-02-17
feat: Support device_id as bucketing identifier for local evaluation
7.8.6 - 2026-02-09
fix: limit collections scanning in code variables
7.8.5 - 2026-02-09
fix: further optimize code variables pattern matching
7.8.4 - 2026-02-09
fix: do not pattern match long values in code variables
7.8.3 - 2026-02-06
fix: openAI input image sanitization
7.8.2 - 2026-02-04
fix(llma): fix prompts default url
7.8.1 - 2026-02-03
fix(llma): small fixes for prompt management
7.8.0 - 2026-01-28
feat(llma): add prompt management
Adds the Prompt Management feature. At the time of release, this feature is in a closed alpha.
7.7.0 - 2026-01-15
feat(ai): Add OpenAI Agents SDK integration
Automatic tracing for agent workflows, handoffs, tool calls, guardrails, and custom spans. Includes $ai_total_tokens, $ai_error_type categorization, and $ai_framework property.
7.6.0 - 2026-01-12
feat: add device_id to flags request payload
Add device_id parameter to all feature flag methods, allowing the server to track device identifiers for flag evaluation. The device_id can be passed explicitly or set via context using set_context_device_id().
7.5.1 - 2026-01-07
fix: avoid return from finally block to fix Python 3.14 SyntaxWarning (#361) - thanks @jodal
7.5.0 - 2026-01-06
feat: Capture Langchain, OpenAI and Anthropic errors as exceptions (if exception autocapture is enabled)
feat: Add reference to exception in LLMA trace and span events
7.4.3 - 2026-01-02
Fixes cache creation cost for Langchain with Anthropic
7.4.2 - 2025-12-22
feat: add in_app_modules option to control code variables capturing
7.4.1 - 2025-12-19
fix: extract model from response for OpenAI stored prompts
When using OpenAI stored prompts, the model is defined in the OpenAI dashboard rather than passed in the API request. This fix adds a fallback to extract the model from the response object when not provided in kwargs, ensuring generations show up with the correct model and enabling cost calculations.
7.4.0 - 2025-12-16
feat: Add automatic retries for feature flag requests
Feature flag API requests now automatically retry on transient failures:
- Network errors (connection refused, DNS failures, timeouts)
- Server errors (500, 502, 503, 504)
- Up to 2 retries with exponential backoff (0.5s, 1s delays)
Rate limit (429) and quota (402) errors are not retried.
7.3.1 - 2025-12-06
fix: remove unused $exception_message and $exception_type
7.3.0 - 2025-12-05
feat: improve code variables capture masking
7.2.0 - 2025-12-01
feat: add $feature_flag_evaluated_at properties to $feature_flag_called events
7.1.0 - 2025-11-26
Add support for the async version of Gemini.
7.0.2 - 2025-11-18
Add support for Python 3.14.
Projects upgrading to Python 3.14 should ensure any Pydantic models passed into the SDK use Pydantic v2, as Pydantic v1 is not compatible with Python 3.14.
7.0.1 - 2025-11-15
Try to use repr() when formatting code variables
7.0.0 - 2025-11-11
NB Python 3.9 is no longer supported
- chore(llma): update LLM provider SDKs to latest major versions
- openai: 1.102.0 → 2.7.1
- anthropic: 0.64.0 → 0.72.0
- google-genai: 1.32.0 → 1.49.0
- langchain-core: 0.3.75 → 1.0.3
- langchain-openai: 0.3.32 → 1.0.2
- langchain-anthropic: 0.3.19 → 1.0.1
- langchain-community: 0.3.29 → 0.4.1
- langgraph: 0.6.6 → 1.0.2
6.9.3 - 2025-11-10
- feat(ph-ai): PostHog properties dict in GenerationMetadata
6.9.2 - 2025-11-10
- fix(llma): fix cache token double subtraction in Langchain for non-Anthropic providers causing negative costs
6.9.1 - 2025-11-07
- fix(error-tracking): pass code variables config from init to client
6.9.0 - 2025-11-06
- feat(error-tracking): add local variables capture
6.8.0 - 2025-11-03
- feat(llma): send web search calls to be used for LLM cost calculations
6.7.14 - 2025-11-03
- fix(django): Handle request.user access in async middleware context to prevent SynchronousOnlyOperation errors in Django 5+ (fixes #355)
- test(django): Add Django 5 integration test suite with real ASGI application testing async middleware behavior
6.7.13 - 2025-11-02
- fix(llma): cache cost calculation in the LangChain callback
6.7.12 - 2025-11-02
- fix(django): Restore process_exception method to capture view and downstream middleware exceptions (fixes #329)
- fix(ai/langchain): Add LangChain 1.0+ compatibility for CallbackHandler imports (fixes #362)
6.7.11 - 2025-10-28
- feat(ai): Add
$ai_framework property for framework integrations (e.g. LangChain)
6.7.10 - 2025-10-24
- fix(django): Make middleware truly hybrid - compatible with both sync (WSGI) and async (ASGI) Django stacks without breaking sync-only deployments
6.7.9 - 2025-10-22
- fix(flags): multi-condition flags with static cohorts returning wrong variants
6.7.8 - 2025-10-16
- fix(llma): missing async for OpenAI's streaming implementation
6.7.7 - 2025-10-14
- fix: remove deprecated attribute $exception_personURL from exception events
6.7.6 - 2025-09-16
- fix: don't sort condition sets with variant overrides to the top
- fix: Prevent core Client methods from raising exceptions
6.7.5 - 2025-09-16
- feat: Django middleware now supports async request handling.
6.7.4 - 2025-09-05
- fix: Missing system prompts for some providers
6.7.3 - 2025-09-04
- fix: missing usage tokens in Gemini
6.7.2 - 2025-09-03
- fix: tool call results in streaming providers
6.7.1 - 2025-09-01
- fix: Add base64 inline image sanitization
6.7.0 - 2025-08-26
- feat: Add support for feature flag dependencies
6.6.1 - 2025-08-21
- fix: Prevent
NoneType error when group_properties is None
6.6.0 - 2025-08-15
- feat: Add
flag_keys_to_evaluate parameter to optimize feature flag evaluation performance by only evaluating specified flags
- feat: Add
flag_keys_filter option to send_feature_flags for selective flag evaluation in capture events
6.5.0 - 2025-08-08
- feat: Add
$context_tags to an event to know which properties were included as tags
6.4.1 - 2025-08-06
- fix: Always pass project API key in
remote_config requests for deterministic project routing
6.4.0 - 2025-08-05
- feat: support Vertex AI for Gemini
6.3.4 - 2025-08-04
- fix: set
$ai_tools for all providers and $ai_output_choices for all non-streaming provider flows properly
6.3.3 - 2025-08-01
- fix:
get_feature_flag_result now correctly returns FeatureFlagResult when payload is empty string instead of None
6.3.2 - 2025-07-31
- fix: Anthropic's tool calls are now handled properly
6.3.0 - 2025-07-22
- feat: Enhanced
send_feature_flags parameter to accept SendFeatureFlagsOptions object for declarative control over local/remote evaluation and custom properties
6.2.1 - 2025-07-21
- feat: make
posthog_client an optional argument in PostHog AI providers wrappers (posthog.ai.*), intuitively using the default client as the default
6.1.1 - 2025-07-16
- fix: correctly capture exceptions processed by Django from views or middleware
6.1.0 - 2025-07-10
- feat: decouple feature flag local evaluation from personal API keys; support decrypting remote config payloads without relying on the feature flags poller
6.0.4 - 2025-07-09
- fix: add POSTHOG_MW_CLIENT setting to django middleware, to support custom clients for exception capture.
6.0.3 - 2025-07-07
- feat: add a feature flag evaluation cache (local storage or redis) to support returning flag evaluations when the service is down
6.0.2 - 2025-07-02
- fix: send_feature_flags changed to default to false in
Client::capture_exception
6.0.1
- fix: response
$process_person_profile property when passed to capture
6.0.0
This release contains a number of major breaking changes:
- feat: make distinct_id an optional parameter in posthog.capture and related functions
- feat: make capture and related functions return
Optional[str], which is the UUID of the sent event, if it was sent
- fix: remove
identify (prefer posthog.set()), and page and screen (prefer posthog.capture())
- fix: delete exception-capture specific integrations module. Prefer the general-purpose django middleware as a replacement for the django
Integration.
To migrate to this version, you'll mostly just need to switch to using named keyword arguments, rather than positional ones. For example:
# Old calling convention
posthog.capture("user123", "button_clicked", {"button_id": "123"})
# New calling convention
posthog.capture(distinct_id="user123", event="button_clicked", properties={"button_id": "123"})
# Better pattern
with posthog.new_context():
posthog.identify_context("user123")
# The event name is the first argument, and can be passed positionally, or as a keyword argument in a later position
posthog.capture("button_pressed")
Generally, arguments are now appropriately typed, and docstrings have been updated. If something is unclear, please open an issue, or submit a PR!
5.4.0 - 2025-06-20
- feat: add support to session_id context on page method
5.3.0 - 2025-06-19
- fix: safely handle exception values
5.2.0 - 2025-06-19
- feat: construct artificial stack traces if no traceback is available on a captured exception
5.1.0 - 2025-06-18
- feat: session and distinct ID's can now be associated with contexts, and are used as such
- feat: django http request middleware
5.0.0 - 2025-06-16
- fix: removed deprecated sentry integration
4.10.0 - 2025-06-13
- fix: no longer fail in autocapture.
4.9.0 - 2025-06-13
- feat(ai): track reasoning and cache tokens in the LangChain callback
4.8.0 - 2025-06-10
- fix: export scoped, rather than tracked, decorator
- feat: allow use of contexts without error tracking
4.7.0 - 2025-06-10
- feat: add support for parse endpoint in responses API (no longer beta)
4.6.2 - 2025-06-09
- fix: replace
import posthog with direct method imports
4.6.1 - 2025-06-09
- fix: replace
import posthog in posthoganalytics package
4.6.0 - 2025-06-09
- feat: add additional user and request context to captured exceptions via the Django integration
- feat: Add
setup() function to initialise default client
4.5.0 - 2025-06-09
- feat: add before_send callback (#249)
4.4.2- 2025-06-09
- empty point release to fix release automation
4.4.1 2025-06-09
- empty point release to fix release automation
4.4.0 - 2025-06-09
- Use the new
/flags endpoint for all feature flag evaluations (don't fall back to /decide at all)
4.3.2 - 2025-06-06
- Add context management:
- New context manager with
posthog.new_context()
- Tag functions:
posthog.tag(), posthog.get_tags(), posthog.clear_tags()
- Function decorator:
@posthog.scoped - Creates context and captures exceptions thrown within the function
- Automatic deduplication of exceptions to ensure each exception is only captured once
- fix: feature flag request use geoip_disable (#235)
- chore: pin actions versions (#210)
- fix: opinionated setup and clean fn fix (#240)
- fix: release action failed (#241)
4.2.0 - 2025-05-22
Add support for google gemini
4.1.0 - 2025-05-22
Moved ai openai package to a composition approach over inheritance.
4.0.1 – 2025-04-29
- Remove deprecated
monotonic library. Use Python's core time.monotonic function instead
- Clarify Python 3.9+ is required
4.0.0 - 2025-04-24
- Added new method
get_feature_flag_result which returns a FeatureFlagResult object. This object breaks down the result of a feature flag into its enabled state, variant, and payload. The benefit of this method is it allows you to retrieve the result of a feature flag and its payload in a single API call. You can call get_value on the result to get the value of the feature flag, which is the same value returned by get_feature_flag (aka the string variant if the flag is a multivariate flag or the boolean value if the flag is a boolean flag).
Example:
result = posthog.get_feature_flag_result("my-flag", "distinct_id")
print(result.enabled) # True or False
print(result.variant) # 'the-variant-value' or None
print(result.payload) # {'foo': 'bar'}
print(result.get_value()) # 'the-variant-value' or True or False
print(result.reason) # 'matched condition set 2' (Not available for local evaluation)
Breaking change:
get_feature_flag_payload now deserializes payloads from JSON strings to Any. Previously, it returned the payload as a JSON encoded string.
Before:
payload = get_feature_flag_payload('key', 'distinct_id') # "{\"some\": \"payload\"}"
After:
payload = get_feature_flag_payload('key', 'distinct_id') # {"some": "payload"}
3.25.0 – 2025-04-15
- Roll out new
/flags endpoint to 100% of /decide traffic, excluding the top 10 customers.
3.24.3 – 2025-04-15
- Fix hash inclusion/exclusion for flag rollout
3.24.2 – 2025-04-15
- Roll out new /flags endpoint to 10% of /decide traffic
3.24.1 – 2025-04-11
- Add
log_captured_exceptions option to proxy setup
3.24.0 – 2025-04-10
- Add config option to
log_captured_exceptions
3.23.0 – 2025-03-26
- Expand automatic retries to include read errors (e.g. RemoteDisconnected)
3.22.0 – 2025-03-26
- Add more information to
$feature_flag_called events.
- Support for the
/decide?v=4 endpoint which contains more information about feature flags.
3.21.0 – 2025-03-17
- Support serializing dataclasses.
3.20.0 – 2025-03-13
- Add support for OpenAI Responses API.
3.19.2 – 2025-03-11
- Fix install requirements for analytics package
3.19.1 – 2025-03-11
- Fix bug where None is sent as delta in azure
3.19.0 – 2025-03-04
- Add support for tool calls in OpenAI and Anthropic.
- Add support for cached tokens.
3.18.1 – 2025-03-03
- Improve quota-limited feature flag logs
3.18.0 - 2025-02-28
- Add support for Azure OpenAI.
3.17.0 - 2025-02-27
- The LangChain handler now captures tools in
$ai_generation events, in property $ai_tools. This allows for displaying tools provided to the LLM call in PostHog UI. Note that support for $ai_tools in OpenAI and Anthropic SDKs is coming soon.
3.16.0 - 2025-02-26
- feat: add some platform info to events (#198)
3.15.1 - 2025-02-23
- Fix async client support for OpenAI.
3.15.0 - 2025-02-19
- Support quota-limited feature flags
3.14.2 - 2025-02-19
- Evaluate feature flag payloads with case sensitivity correctly. Fixes https://github.com/PostHog/posthog-python/issues/178
3.14.1 - 2025-02-18
- Add support for Bedrock Anthropic Usage
3.13.0 - 2025-02-12
- Automatically retry connection errors
3.12.1 - 2025-02-11
- Fix mypy support for 3.12.0
- Deprecate
is_simple_flag
3.12.0 - 2025-02-11
- Add support for OpenAI beta parse API.
- Deprecate
context parameter
3.11.1 - 2025-02-06
- Fix LangChain callback handler to capture parent run ID.
3.11.0 - 2025-01-28
-
Add the $ai_span event to the LangChain callback handler to capture the input and output of intermediary chains.
LLM observability naming change: event property $ai_trace_name is now $ai_span_name.
-
Fix serialiazation of Pydantic models in methods.
3.10.0 - 2025-01-24
- Add
$ai_error and $ai_is_error properties to LangChain callback handler, OpenAI, and Anthropic.
3.9.3 - 2025-01-23
- Fix capturing of multiple traces in the LangChain callback handler.
3.9.2 - 2025-01-22
- Fix importing of LangChain callback handler under certain circumstances.
3.9.0 - 2025-01-22
- Add
$ai_trace event emission to LangChain callback handler.
3.8.4 - 2025-01-17
- Add Anthropic support for LLM Observability.
- Update LLM Observability to use output_choices.
3.8.3 - 2025-01-14
- Fix setuptools to include the
posthog.ai.openai and posthog.ai.langchain packages for the posthoganalytics package.
3.8.2 - 2025-01-14
- Fix setuptools to include the
posthog.ai.openai and posthog.ai.langchain packages.
3.8.1 - 2025-01-14
- Add LLM Observability with support for OpenAI and Langchain callbacks.
3.7.5 - 2025-01-03
- Add
distinct_id to group_identify
3.7.4 - 2024-11-25
- Fix bug where this SDK incorrectly sent feature flag events with null values when calling
get_feature_flag_payload.
3.7.3 - 2024-11-25
- Use personless mode when sending an exception without a provided
distinct_id.
3.7.2 - 2024-11-19
- Add
type property to exception stacks.
3.7.1 - 2024-10-24
- Add
platform property to each frame of exception stacks.
3.7.0 - 2024-10-03
- Adds a new
super_properties parameter on the client that are appended to every /capture call.
3.6.7 - 2024-09-24
- Remove deprecated datetime.utcnow() in favour of datetime.now(tz=tzutc())
3.6.6 - 2024-09-16
- Fix manual capture support for in app frames
3.6.5 - 2024-09-10
- Fix django integration support for manual exception capture.
3.6.4 - 2024-09-05
- Add manual exception capture.
3.6.3 - 2024-09-03
- Make sure setup.py for posthoganalytics package also discovers the new exception integration package.
3.6.2 - 2024-09-03
- Make sure setup.py discovers the new exception integration package.
3.6.1 - 2024-09-03
- Adds django integration to exception autocapture in alpha state. This feature is not yet stable and may change in future versions.
3.6.0 - 2024-08-28
- Adds exception autocapture in alpha state. This feature is not yet stable and may change in future versions.
3.5.2 - 2024-08-21
- Guard for None values in local evaluation
3.5.1 - 2024-08-13
- Remove "-api" suffix from ingestion hostnames
3.5.0 - 2024-02-29
-
- Adds a new
feature_flags_request_timeout_seconds timeout parameter for feature flags which defaults to 3 seconds, updated from the default 10s for all other API calls.
3.4.2 - 2024-02-20
- Add
historical_migration option for bulk migration to PostHog Cloud.
3.4.1 - 2024-02-09
- Use new hosts for event capture as well
3.4.0 - 2024-02-05
- Point given hosts to new ingestion hosts
3.3.4 - 2024-01-30
- Update type hints for module variables to work with newer versions of mypy
3.3.3 - 2024-01-26
- Remove new relative date operators, combine into regular date operators
3.3.2 - 2024-01-19
- Return success/failure with all capture calls from module functions
3.3.1 - 2024-01-10
- Make sure we don't override any existing feature flag properties when adding locally evaluated feature flag properties.
3.3.0 - 2024-01-09
- When local evaluation is enabled, we automatically add flag information to all events sent to PostHog, whenever possible. This makes it easier to use these events in experiments.
3.2.0 - 2024-01-09
- Numeric property handling for feature flags now does the expected: When passed in a number, we do a numeric comparison. When passed in a string, we do a string comparison. Previously, we always did a string comparison.
- Add support for relative date operators for local evaluation.
3.1.0 - 2023-12-04
- Increase maximum event size and batch size
3.0.2 - 2023-08-17
- Returns the current flag property with $feature_flag_called events, to make it easier to use in experiments
3.0.1 - 2023-04-21
- Restore how feature flags work when the client library is disabled: All requests return
None and no events are sent when the client is disabled.
- Add a
feature_flag_definitions() debug option, which returns currently loaded feature flag definitions. You can use this to more cleverly decide when to request local evaluation of feature flags.
3.0.0 - 2023-04-14
Breaking change:
All events by default now send the $geoip_disable property to disable geoip lookup in app. This is because usually we don't
want to update person properties to take the server's location.
The same now happens for feature flag requests, where we discard the IP address of the server for matching on geoip properties like city, country, continent.
To restore previous behaviour, you can set the default to False like so:
posthog.disable_geoip = False
# // and if using client instantiation:
posthog = Posthog('api_key', disable_geoip=False)
2.5.0 - 2023-04-10
- Add option for instantiating separate client object
2.4.2 - 2023-03-30
- Update backoff dependency for posthoganalytics package to be the same as posthog package
2.4.1 - 2023-03-17
- Removes accidental print call left in for decide response
2.4.0 - 2023-03-14
- Support evaluating all cohorts in feature flags for local evaluation
2.3.1 - 2023-02-07
- Log instead of raise error on posthog personal api key errors
- Remove upper bound on backoff dependency
2.3.0 - 2023-01-31
- Add support for returning payloads of matched feature flags
2.2.0 - 2022-11-14
Changes:
- Add support for feature flag variant overrides with local evaluation
2.1.2 - 2022-09-15
Changes:
- Fixes issues with date comparison.
2.1.1 - 2022-09-14
Changes:
- Feature flags local evaluation now supports date property filters as well. Accepts both strings and datetime objects.
2.1.0 - 2022-08-11
Changes:
- Feature flag defaults have been removed
- Setup logging only when debug mode is enabled.
2.0.1 - 2022-08-04
- Make poll_interval configurable
- Add
send_feature_flag_events parameter to feature flag calls, which determine whether the $feature_flag_called event should be sent or not.
- Add
only_evaluate_locally parameter to feature flag calls, which determines whether the feature flag should only be evaluated locally or not.
2.0.0 - 2022-08-02
Breaking changes:
- The minimum version requirement for PostHog servers is now 1.38. If you're using PostHog Cloud, you satisfy this requirement automatically.
- Feature flag defaults apply only when there's an error fetching feature flag results. Earlier, if the default was set to
True, even if a flag resolved to False, the default would override this.
Note: These are removed in 2.0.2
- Feature flag remote evaluation doesn't require a personal API key.
New Changes:
- You can now evaluate feature flags locally (i.e. without sending a request to your PostHog servers) by setting a personal API key, and passing in groups and person properties to
is_feature_enabled and get_feature_flag calls.
- Introduces a
get_all_flags method that returns all feature flags. This is useful for when you want to seed your frontend with some initial flags, given a user ID.
1.4.9 - 2022-06-13
- Support for sending feature flags with capture calls
1.4.8 - 2022-05-12
- Support multi variate feature flags
1.4.7 - 2022-04-25
- Allow feature flags usage without project_api_key
1.4.1 - 2021-05-28
- Fix packaging issues with Sentry integrations
1.4.0 - 2021-05-18
- Improve support for
project_api_key (#32)
- Resolve polling issues with feature flags (#29)
- Add Sentry (and Sentry+Django) integrations (#13)
- Fix feature flag issue with no percentage rollout (#30)
1.3.1 - 2021-05-07
- Add
$set and $set_once support (#23)
- Add distinct ID to
$create_alias event (#27)
- Add
UUID to ID_TYPES (#26)
1.2.1 - 2021-02-05
Initial release logged in CHANGELOG.md.