Skip to content

Commit e129027

Browse files
committed
docs: say options beat legacy properties at every layer
1 parent 9769723 commit e129027

1 file changed

Lines changed: 2 additions & 1 deletion

File tree

‎docs/migration-7.x-to-8.0.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,8 @@ Capture v1 sends processing options in an `options` object, next to `properties`
9191
- `set_context_option(key, value)` sets an option for the current context, like `tag()`.
9292
- Options are sent as given. PostHog validates them.
9393
- The legacy properties `$cookieless_mode`, `$ignore_sent_at`, `$product_tour_id` and `$process_person_profile` still work. They move into options after `before_send`. Their values are no longer converted, so pass `True` or `False`, not `"true"`.
94-
- An option wins over its legacy property. A `None` option counts as unset.
94+
- An option set at any layer wins over its legacy property set at any layer. For example, `super_options={"cookieless_mode": True}` wins over an event's `$cookieless_mode: False`. When you move a default to options, move the per-event overrides of that key to options too.
95+
- A `None` option counts as unset.
9596

9697
Values apply in this order, and each layer overrides the ones before it:
9798

0 commit comments

Comments
 (0)