New masking API, remote settings, and more
·
82 commits
to master
since this release
Immutable
release. Only release title and notes can be modified.
New Recorder Masking API
Session recording now supports unmasking inputs, as well as an allow-list based masking API for both inputs and text. New configuration options:
| Option | Type | Default | Description |
|---|---|---|---|
record_mask_all_text |
boolean |
true |
When true, all text is masked by default. Use record_unmask_text_selector to selectively reveal specific elements. |
record_mask_text_selector |
string | string[] |
undefined |
CSS selector(s) for elements to mask. Only applies when record_mask_all_text is false. |
record_unmask_text_selector |
string | string[] |
undefined |
CSS selector(s) for elements to unmask. Only applies when record_mask_all_text is true. |
record_mask_all_inputs |
boolean |
true |
When true, all inputs are masked by default. Use record_unmask_input_selector to selectively reveal specific inputs. |
record_mask_input_selector |
string | string[] |
"" |
CSS selector(s) for inputs to mask. Only applies when record_mask_all_inputs is false. |
record_unmask_input_selector |
string | string[] |
"" |
CSS selector(s) for inputs to unmask. Only applies when record_mask_all_inputs is true. |
Old record_mask_text_selector configuration options are migrated to the equivalent new config options for compatibility - e.g. record_mask_text_selector: '' will be applied as record_mask_all_text: false
Initial Remote Settings Support
Preparation to support remote settings functionality which will allow customizing session recording configurations (and eventually more) within the Mixpanel UI. The config option remote_settings_mode allows 3 states:
strict- do not act (for instance, start session recording) unless the remote settings are loaded in a timely mannerfallback- use fallback configuration values (options set during initialization) if remote settings fail to load in a timely mannerdisabled(default) - do not use or attempt to load remote settings
Remote settings are currently in a CLOSED alpha as of 1/27/2026, and the SDK API could be updated with breaking changes.