:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { LemonBanner, LemonTag, Link, Tooltip } from '@posthog/lemon-ui'
import { LLMProviderKeysSettings } from '@posthog/products-ai-observability/frontend/settings/LLMProviderKeysSettings'
import { ParserRecipesSettings } from '@posthog/products-ai-observability/frontend/settings/ParserRecipesSettings'
import { ErrorTrackingAlerting } from '@posthog/products-error-tracking/frontend/scenes/ErrorTrackingConfigurationScene/alerting/ErrorTrackingAlerting'
import { AssignmentRules } from '@posthog/products-error-tracking/frontend/scenes/ErrorTrackingConfigurationScene/assignment_rules/AssignmentRules'
import { GroupingRules } from '@posthog/products-error-tracking/frontend/scenes/ErrorTrackingConfigurationScene/grouping_rules/GroupingRules'
import { RateLimitSettings } from '@posthog/products-error-tracking/frontend/scenes/ErrorTrackingConfigurationScene/rate_limit/RateLimitSettings'
import { Releases } from '@posthog/products-error-tracking/frontend/scenes/ErrorTrackingConfigurationScene/releases/Releases'
import { SeverityRules } from '@posthog/products-error-tracking/frontend/scenes/ErrorTrackingConfigurationScene/severity_rules/SeverityRules'
import { SpikeDetectionSettings } from '@posthog/products-error-tracking/frontend/scenes/ErrorTrackingConfigurationScene/spike_detection/SpikeDetectionSettings'
import { SymbolSets } from '@posthog/products-error-tracking/frontend/scenes/ErrorTrackingConfigurationScene/symbol_sets/SymbolSets'
import { McpCustomHarnessesSettings } from '@posthog/products-mcp-analytics/frontend/settings/McpCustomHarnessesSettings'
import { McpStoreSettings } from '@posthog/products-mcp-store/frontend/McpStoreSettings'
import { EventConfiguration } from '@posthog/products-revenue-analytics/frontend/settings/EventConfiguration'
import { ExternalDataSourceConfiguration } from '@posthog/products-revenue-analytics/frontend/settings/ExternalDataSourceConfiguration'
import { FilterTestAccountsConfiguration as RevenueAnalyticsFilterTestAccountsConfiguration } from '@posthog/products-revenue-analytics/frontend/settings/FilterTestAccountsConfiguration'
import { BaseCurrency } from 'lib/components/BaseCurrency/BaseCurrency'
import { FeaturePreviews, FeaturePreviewsComingSoon } from 'lib/components/FeaturePreviews/FeaturePreviews'
import { FEATURE_SUPPORT } from 'lib/components/SupportedPlatforms/featureSupport'
import { OrganizationMembershipLevel } from 'lib/constants'
import { PersonalPosthogConnections } from 'lib/integrations/PosthogConnect'
import { DefaultMinimumDetectableEffect } from 'scenes/experiments/DefaultMinimumDetectableEffect'
import { GitHub, GitLab, Linear, Slack } from 'scenes/integrations/definitions'
import { AgentPersonalInstructionsSettings } from 'scenes/settings/environment/AgentPersonalInstructionsSettings'
import { AgentProjectInstructionsSettings } from 'scenes/settings/environment/AgentProjectInstructionsSettings'
import { BounceRateDurationSetting } from 'scenes/settings/environment/BounceRateDuration'
import { BounceRatePageViewModeSetting } from 'scenes/settings/environment/BounceRatePageViewMode'
import { CookielessServerHashModeSetting } from 'scenes/settings/environment/CookielessServerHashMode'
import { CustomBotRules } from 'scenes/settings/environment/CustomBotRules'
import { CustomChannelTypes } from 'scenes/settings/environment/CustomChannelTypes'
import { DeadClicksAutocaptureSettings } from 'scenes/settings/environment/DeadClicksAutocaptureSettings'
import { MaxChangelogSettings } from 'scenes/settings/environment/MaxChangelogSettings'
import { MaxMemorySettings } from 'scenes/settings/environment/MaxMemorySettings'
import { PersonLastSeenAtEnabled } from 'scenes/settings/environment/PersonLastSeenAtEnabled'
import { PersonsJoinMode } from 'scenes/settings/environment/PersonsJoinMode'
import { PersonsOnEvents } from 'scenes/settings/environment/PersonsOnEvents'
import { PreAggregatedTablesSetting } from 'scenes/settings/environment/PreAggregatedTablesSetting'
import { ReplayTriggers } from 'scenes/settings/environment/ReplayTriggers'
import { SessionsTableVersion } from 'scenes/settings/environment/SessionsTableVersion'
import {
TaskAgentMyPreferenceSettings,
TaskAgentProjectDefaultSettings,
} from 'scenes/settings/environment/TaskAgentDefaultsSettings'
import { OrganizationMCPAccess } from 'scenes/settings/organization/OrganizationMCPAccess'
import { urls } from 'scenes/urls'
import { ConfigScopeEnumApi } from '~/generated/core/api.schemas'
import { AccessResolutionPreview } from '~/layout/navigation-3000/sidepanel/panels/access_control/ResolutionPreview/AccessResolutionPreview'
import {
DefaultRoleSelector,
RolesAccessControls,
} from '~/layout/navigation-3000/sidepanel/panels/access_control/RolesAccessControls'
import { AccessControlLevel, AccessControlResourceType, AvailableFeature, Realm } from '~/types'
import { DevModeSetting } from 'products/ai_gateway/frontend/components/DevModeSetting'
import { DevModeTeamUsage } from 'products/ai_gateway/frontend/components/DevModeTeamUsage'
import { GithubReposSetting } from 'products/business_knowledge/frontend/scenes/settings/GithubReposSetting'
import { LearnFromSupportSetting } from 'products/business_knowledge/frontend/scenes/settings/LearnFromSupportSetting'
import { AISection } from 'products/conversations/frontend/scenes/settings/AISection'
import { GeneralSection } from 'products/conversations/frontend/scenes/settings/GeneralSection'
import { MacrosSection } from 'products/conversations/frontend/scenes/settings/MacrosSection'
import { NotificationsSection } from 'products/conversations/frontend/scenes/settings/NotificationsSection'
import { ZendeskImportSection } from 'products/conversations/frontend/scenes/settings/ZendeskImportSection'
import { CustomerAnalyticsNotifications } from 'products/customer_analytics/frontend/components/TaskDigest/CustomerAnalyticsNotifications'
import { AccountTrackRules } from 'products/customer_analytics/frontend/scenes/CustomerAnalyticsConfigurationScene/account/AccountTrackRules'
import { CustomerAnalyticsAccountConfig } from 'products/customer_analytics/frontend/scenes/CustomerAnalyticsConfigurationScene/account/CustomerAnalyticsAccountConfig'
import {
WarehouseGroupPropertiesSetting,
WarehousePersonPropertiesSetting,
} from 'products/customer_analytics/frontend/scenes/CustomerAnalyticsConfigurationScene/account/WarehousePersonPropertiesSetting'
import { CalendarSyncConfig } from 'products/customer_analytics/frontend/scenes/CustomerAnalyticsConfigurationScene/calendar/CalendarSyncConfig'
import { CustomerAnalyticsDashboardEvents } from 'products/customer_analytics/frontend/scenes/CustomerAnalyticsConfigurationScene/events/CustomerAnalyticsDashboardEvents'
import { DataQualityGateToggle } from 'products/data_quality/frontend/settings/DataQualityGateToggle'
import { ExceptionAutocaptureToggle } from 'products/error_tracking/frontend/scenes/ErrorTrackingConfigurationScene/exception_autocapture/ExceptionAutocaptureSettings'
import { GeneralSettings } from 'products/error_tracking/frontend/scenes/ErrorTrackingConfigurationScene/general/GeneralSettings'
import { SuppressionRules } from 'products/error_tracking/frontend/scenes/ErrorTrackingConfigurationScene/suppression_rules/SuppressionRules'
import { MAX_LOOKBACK_DAYS, MIN_LOOKBACK_DAYS } from 'products/experiments/frontend/constants'
import { FeatureFlagRequestBlocklist } from 'products/feature_flags/frontend/FeatureFlagRequestBlocklist'
import { LogsAlertingSection } from 'products/logs/frontend/components/LogsAlerting/LogsAlertingSection'
import { LogsMetricRulesSection } from 'products/logs/frontend/components/LogsMetricRules/LogsMetricRulesSection'
import { LogsSamplingSection } from 'products/logs/frontend/components/LogsSampling/LogsSamplingSection'
import { OrganizationEventsRetentionSetting } from 'products/product_analytics/frontend/settings/OrganizationEventsRetentionSetting'
import { ProjectEventsRetentionSetting } from 'products/product_analytics/frontend/settings/ProjectEventsRetentionSetting'
import { TracingRetentionSettingsBlock } from 'products/tracing/frontend/components/TracingRetention/TracingRetentionSettings'
import { HeatmapCaptureSettings } from 'products/web_analytics/frontend/heatmaps/components/HeatmapCaptureSettings'
import { HeatmapScreenshotCookieSettings } from 'products/web_analytics/frontend/heatmaps/components/HeatmapScreenshotCookieSettings'
import { WorkflowsDailyLimitsSettings } from 'products/workflows/frontend/scenes/settings/WorkflowsDailyLimitsSettings'
import { WorkflowsEmailTrackingConsentSettings } from 'products/workflows/frontend/scenes/settings/WorkflowsEmailTrackingConsentSettings'
import { WorkflowsEngagementEventsSettings } from 'products/workflows/frontend/scenes/settings/WorkflowsEngagementEventsSettings'
import { WorkflowsFrequencyCapSettings } from 'products/workflows/frontend/scenes/settings/WorkflowsFrequencyCapSettings'
import { WorkflowsUtmDefaultsSettings } from 'products/workflows/frontend/scenes/settings/WorkflowsUtmDefaultsSettings'
import { SettingScopeTag } from './components/SettingScopeTag'
import {
ActivityLogNotifications,
ActivityLogOrgLevelSettings,
ActivityLogSettings,
} from './environment/ActivityLogSettings'
import { AgentUsageSettings } from './environment/AgentUsageSettings'
import { AutocaptureSettings, WebVitalsAutocaptureSettings } from './environment/AutocaptureSettings'
import { CloudEnvironmentsSettings } from './environment/CloudEnvironmentsSettings'
import { CloudImagesSettings } from './environment/CloudImagesSettings'
import { CSPReportingSettings } from './environment/CSPReportingSettings'
import { DataAttributes } from './environment/DataAttributes'
import { DataColorThemes } from './environment/DataColorThemes'
import { DefaultCupedEnabled } from './environment/DefaultCupedEnabled'
import { DefaultCupedLookbackDays } from './environment/DefaultCupedLookbackDays'
import { DefaultExperimentConfidenceLevel } from './environment/DefaultExperimentConfidenceLevel'
import { DefaultExperimentStatsMethod } from './environment/DefaultExperimentStatsMethod'
import { DefaultOnlyCountMaturedUsers } from './environment/DefaultOnlyCountMaturedUsers'
import { DefaultSequentialTestingEnabled } from './environment/DefaultSequentialTestingEnabled'
import { DefaultSequentialTuningParameter } from './environment/DefaultSequentialTuningParameter'
import { DiscussionMentionNotifications } from './environment/DiscussionSettings'
import { ErrorTrackingConfigurationMovedBanner } from './environment/ErrorTrackingConfigurationMovedBanner'
import { ErrorTrackingIntegrations } from './environment/ErrorTrackingIntegrations'
import { ExperimentRecalculationTime } from './environment/ExperimentRecalculationTime'
import {
DefaultEvaluationContexts,
DefaultReleaseConditions,
EvaluationContextSuggestions,
FlagChangeConfirmationSettings,
FlagPersistenceSettings,
FlagsSecureApiKeys,
RequireEvaluationContexts,
RequireFeatureFlagTags,
} from './environment/FeatureFlagSettings'
import { GroupAnalyticsConfig } from './environment/GroupAnalyticsConfig'
import { HeatmapsSettings } from './environment/HeatmapsSettings'
import { HumanFriendlyComparisonPeriodsSetting } from './environment/HumanFriendlyComparisonPeriodsSetting'
import { IPAllowListInfo } from './environment/IPAllowListInfo'
import { IPCapture } from './environment/IPCapture'
import { JsSnippetVersionPin } from './environment/JsSnippetVersionPin'
import {
LogsCaptureSettings,
LogsJsonParseSettings,
LogsPiiScrubSettings,
LogsRetentionSettingsBlock,
} from './environment/LogsCaptureSettings'
import { LogsDistinctIdAttributeKeys } from './environment/LogsDistinctIdAttributeKeys'
import { LogsJsonParseAttributeSettings } from './environment/LogsJsonParseAttributeSettings'
import { LogsPatternMessageKeys } from './environment/LogsPatternMessageKeys'
import { LogsSessionIdAttributeKeys } from './environment/LogsSessionIdAttributeKeys'
import { ManagedReverseProxy } from './environment/ManagedReverseProxy'
import { MarketingAnalyticsSettingsWrapper } from './environment/MarketingAnalyticsSettingsWrapper'
import MCPServerSettings from './environment/MCPServerSettings'
import { OtherAgentSettings } from './environment/OtherAgentSettings'
import { PathCleaningFiltersConfig } from './environment/PathCleaningFiltersConfig'
import { PersonDisplayNameProperties } from './environment/PersonDisplayNameProperties'
import { ProjectTimezoneName } from './environment/ProjectTimezoneName'
import { ReplayIntegrations } from './environment/ReplayIntegrations'
import { SDKInstallOptions } from './environment/SDKInstallOptions'
import {
CanvasCaptureSettings,
LogCaptureSettings,
ReplayAuthorizedDomains,
ReplayDataRetentionSettings,
ReplayGeneral,
ReplayMaskingSettings,
ReplayNetworkCapture,
ReplayNetworkHeadersPayloads,
} from './environment/SessionRecordingSettings'
import { SurveyDefaultAppearance, SurveyEnableToggle } from './environment/SurveySettings'
import { TaskDefaultsSettings } from './environment/TaskDefaultsSettings'
import { TeamAccessControl } from './environment/TeamAccessControl'
import { TeamAuthorizedURLs, TeamBusinessModel, TeamTimezone, TeamVariables } from './environment/TeamSettings'
import { ProjectAccountFiltersSetting } from './environment/TestAccountFiltersConfig'
import { TracingDistinctIdAttributeKeys } from './environment/TracingDistinctIdAttributeKeys'
import { TracingSessionIdAttributeKeys } from './environment/TracingSessionIdAttributeKeys'
import { UsageMetricsConfig } from './environment/UsageMetricsConfig'
import { WebAnalyticsEnablePreAggregatedTables } from './environment/WebAnalyticsAPISetting'
import { AIHipaaDisclaimer, getExternalAIProvidersTooltipTitle } from './organization/aiConsentCopy'
import { ApprovalPolicies } from './organization/Approvals/ApprovalPolicies'
import { ChangeRequestsList } from './organization/Approvals/ChangeRequestsList'
import { CIMDVerificationTokens } from './organization/CIMDVerificationTokens'
import { IdentityProviderFeatureSection } from './organization/IdentityProviderConfig/IdentityProviderFeatureSection'
import { Invites } from './organization/Invites'
import { Members } from './organization/Members'
import { NotificationGovernanceSetting } from './organization/NotificationGovernanceSetting'
import { OAuthApps } from './organization/OAuthApps'
import { OrganizationAI } from './organization/OrgAI'
import { OrganizationAITrainingOptOut } from './organization/OrgAITraining'
import { OrganizationDangerZone } from './organization/OrganizationDangerZone'
import { OrganizationIntegrations } from './organization/OrganizationIntegrations'
import { OrganizationMemberNotice } from './organization/OrganizationMemberNotice'
import { OrganizationPersonalAPIKeys } from './organization/OrganizationPersonalAPIKeys'
import { OrganizationSecuritySettings } from './organization/OrganizationSecuritySettings'
import { OrganizationDesktopBetaTerms } from './organization/OrgDesktopBetaTerms'
import { OrganizationDisplayName } from './organization/OrgDisplayName'
import { OrgIPAnonymizationDefault } from './organization/OrgIPAnonymizationDefault'
import { OrganizationVariables } from './organization/OrgVariables'
import { SSFSetting } from './organization/SSFSetting'
import { EnforceVerifiedDomains } from './organization/VerifiedDomains/EnforceVerifiedDomains'
import { VerifiedDomains } from './organization/VerifiedDomains/VerifiedDomains'
import { OtherIntegrationsSettings } from './project/OtherIntegrationsSettings'
import { ProjectDangerZone } from './project/ProjectDangerZone'
import { ProjectDetails } from './project/ProjectDetails'
import { ProjectMove } from './project/ProjectMove'
import { ProjectSecretAPIKeys } from './project/ProjectSecretAPIKeys'
import { WorkloadTrustPolicies } from './project/WorkloadTrustPolicies'
import { SettingSection } from './types'
import { AllowImpersonation } from './user/AllowImpersonation'
import { ChangePassword, ChangePasswordTitle } from './user/ChangePassword'
import { ConnectedApps } from './user/ConnectedApps'
import { HedgehogModeSettings } from './user/HedgehogModeSettings'
import { LoginSessions } from './user/LoginSessions'
import { OptOutCapture } from './user/OptOutCapture'
import { PasskeySettings } from './user/PasskeySettings'
import { PersonalAPIKeys } from './user/PersonalAPIKeys'
import { PersonalCodexIntegration } from './user/PersonalCodexIntegration'
import { PersonalGitHubIntegrations, PersonalSlackIntegrations } from './user/PersonalIntegrations'
import { ProfilePictureSettings } from './user/ProfilePictureSettings'
import { RealtimeNotificationPreferences } from './user/RealtimeNotificationPreferences'
import { Reminders } from './user/Reminders'
import { TaskCommentSlackNotifications } from './user/TaskCommentSlackNotifications'
import { ThemeSwitcher } from './user/ThemeSwitcher'
import { TwoFactorSettings } from './user/TwoFactorSettings'
import { UpdateEmailPreferences } from './user/UpdateEmailPreferences'
import { UserDangerZone } from './user/UserDangerZone'
import { UserDetails } from './user/UserDetails'
import { WebAnalyticsAchievementsSetting } from './user/WebAnalyticsAchievementsSetting'
export const SETTINGS_MAP: SettingSection[] = [
// ENVIRONMENT
{
level: 'environment',
id: 'environment-details',
title: 'General',
settings: [
{
id: 'variables',
title: 'Project token & ID',
description:
'Your project token and ID used to connect SDKs and APIs to this environment. Integrations often call the token your project API key.',
component: <TeamVariables />,
keywords: [
'api key',
'project api key',
'client api key',
'public api key',
'write key',
'token',
'project id',
],
},
{
id: 'snippet',
title: 'SDK setup',
description:
'Install PostHog in your app with Wizard, or set it up manually by following the instructions for your platform.',
docsUrl: 'https://posthog.com/docs/getting-started/install',
component: <SDKInstallOptions />,
keywords: [
'install',
'setup',
'tracking',
'code',
'sdk',
'snippet',
'wizard',
'setup agent',
'javascript',
'html',
'react',
'next.js',
'nextjs',
'python',
'node',
'nodejs',
'react native',
'angular',
'astro',
'bubble',
'framer',
'nuxt',
'remix',
'svelte',
'tanstack',
'vue',
'webflow',
'android',
'ios',
'flutter',
'django',
'elixir',
'go',
'laravel',
'php',
'ruby',
'rails',
'api',
'docusaurus',
'google tag manager',
'gtm',
],
},
{
id: 'js-snippet-version',
title: (
<>
Snippet version{' '}
<LemonTag type="warning" className="ml-1 uppercase">
Experimental
</LemonTag>
</>
),
description: 'Pin the snippet to a specific version of posthog-js. Defaults to the latest v1 release.',
flag: ['JS_SNIPPET_VERSIONING'],
component: <JsSnippetVersionPin />,
keywords: ['version', 'pin', 'snippet', 'sdk', 'posthog-js'],
},
],
},
{
level: 'environment',
id: 'environment-customization',
title: 'Customization',
settings: [
{
id: 'display-name',
title: 'Project details',
description:
'Name this project, add a logo and label it so you can group and find it across your organization.',
component: <ProjectDetails />,
keywords: ['name', 'rename', 'logo', 'icon', 'image', 'label', 'tag', 'tags'],
},
{
id: 'date-and-time',
title: 'Date & time',
description:
'Set the timezone and week start day used for displaying and bucketing time-series data in insights and dashboards. You may need to refresh insights for changes to apply.',
component: <TeamTimezone />,
keywords: ['timezone', 'utc', 'locale', 'week start'],
},
{
// Project-wide, not product analytics specific: these filters apply to insights,
// web analytics, revenue analytics, session replay, and CDP destinations alike.
id: 'internal-user-filtering',
title: 'Filter out internal and test users',
description:
'Add filters that match the users you want to keep, for example "email does not contain yourcompany.com". When this filter is on, events that do not match every filter are hidden from insights. A destination applies these filters only when "Filter out internal and test users" is turned on in its filters.',
docsUrl: 'https://posthog.com/tutorials/filter-internal-users',
component: <ProjectAccountFiltersSetting />,
keywords: ['test account', 'internal', 'exclude', 'filter'],
},
{
// Project-wide, like internal user filtering above: these definitions feed the
// `Is bot` property, which is available to every query, not only web analytics.
id: 'custom-bot-definitions',
title: 'Custom bots',
description:
'Add your own crawlers and scripts to the bots PostHog already detects, so you can tell them apart from real visitors.',
docsUrl: 'https://posthog.com/docs/web-analytics/bot-detection',
component: <CustomBotRules />,
keywords: ['bot', 'crawler', 'spider', 'scraper', 'user agent', 'ai'],
},
{
id: 'business-model',
title: 'Business model',
description:
'Set whether this project serves B2B or B2C customers so PostHog can tailor the experience and recommendations.',
component: <TeamBusinessModel />,
keywords: ['b2b', 'b2c', 'saas', 'ecommerce'],
},
{
id: 'base-currency',
title: 'Base currency',
description: 'Set the default currency used for revenue and monetary calculations.',
component: <BaseCurrency hideTitle />,
keywords: ['money', 'currency', 'usd', 'eur'],
},
],
},
{
level: 'environment',
id: 'environment-max',
title: 'PostHog AI',
group: 'AI',
settings: [
{
id: 'core-memory',
title: 'Memory',
description:
"PostHog AI automatically remembers details about your company and product. This context helps our AI assistant provide relevant answers and suggestions. If there are any details you don't want PostHog AI to remember, you can edit or remove them below.",
component: <MaxMemorySettings />,
hideOn: [Realm.SelfHostedClickHouse, Realm.SelfHostedPostgres],
},
{
// FIXME: changelog should probably not be here since it updates user's settings. Maybe belongs under account settings?
id: 'changelog',
title: 'Changelog',
description:
'See the latest PostHog AI features and control whether the changelog appears in the main UI.',
component: <MaxChangelogSettings />,
hideOn: [Realm.SelfHostedClickHouse, Realm.SelfHostedPostgres],
},
],
},
{
level: 'environment',
id: 'environment-task-agents',
title: 'Agent preferences',
group: 'AI',
flag: 'TODAY_RAIL_NAV',
keywords: ['model preferences', 'personalization', 'desktop'],
settings: [
{
id: 'task-agent-project-default',
title: (
<>
Project default model
<SettingScopeTag scope="project" />
</>
),
searchTerm: 'Project default model',
description:
'The model agent runs launch with when nobody picks one. Everyone on this project inherits it in the new PostHog AI view, in Slack, and in PostHog Desktop.',
component: <TaskAgentProjectDefaultSettings />,
keywords: ['ai', 'model', 'claude', 'codex', 'agent', 'tasks', 'default', 'slack', 'desktop'],
},
{
id: 'task-agent-my-preference',
title: (
<>
My default model
<SettingScopeTag scope="user" />
</>
),
searchTerm: 'My default model',
description:
'The model your own runs launch with, overriding the project default. Applies in the new PostHog AI view, in Slack, and in PostHog Desktop.',
component: <TaskAgentMyPreferenceSettings />,
keywords: ['ai', 'model', 'claude', 'codex', 'agent', 'tasks', 'preference', 'slack', 'desktop'],
},
{
id: 'task-agent-new-task-defaults',
title: (
<>
New tasks
<SettingScopeTag scope="user" />
</>
),
searchTerm: 'New tasks',
description:
'How tasks you start from PostHog AI begin. In plan mode, the agent makes a plan and waits for your approval. You can still pick another mode for each task.',
component: <TaskDefaultsSettings />,
keywords: [
'plan mode',
'start in',
'pull request',
'draft pr',
'auto publish',
'cloud runs',
'desktop',
],
},
{
id: 'task-agent-other-settings',
title: 'Other agent settings',
description: 'Where to find the agent settings that are not on this page.',
component: <OtherAgentSettings />,
keywords: [
'self-driving',
'signals',
'scouts',
'agents',
'skills',
'workspaces',
'worktrees',
'terminal',
'harness',
'permission rules',
'keep awake',
'discord',
'updates',
'desktop',
],
},
],
},
{
level: 'environment',
id: 'environment-task-agents',
title: 'Model preferences',
group: 'AI',
flag: '!TODAY_RAIL_NAV',
settings: [
{
id: 'task-agent-project-default',
title: 'Project default model',
description:
'The model agent runs launch with when nobody picks one. Everyone on this project inherits it in the new PostHog AI view, in Slack, and in PostHog Desktop.',
component: <TaskAgentProjectDefaultSettings />,
keywords: ['ai', 'model', 'claude', 'codex', 'agent', 'tasks', 'default', 'slack', 'desktop'],
},
{
id: 'task-agent-my-preference',
title: 'My default model',
description:
'The model your own runs launch with, overriding the project default. Applies in the new PostHog AI view, in Slack, and in PostHog Desktop.',
component: <TaskAgentMyPreferenceSettings />,
keywords: ['ai', 'model', 'claude', 'codex', 'agent', 'tasks', 'preference', 'slack', 'desktop'],
},
],
},
{
level: 'environment',
id: 'environment-ai-subscriptions',
title: 'Bring your own subscription',
group: 'AI',
flag: ['POSTHOG_CODE_CODEX_OWN_SUBSCRIPTION_CLOUD', 'TODAY_RAIL_NAV'],
keywords: ['subscriptions', 'byos', 'plan & usage'],
settings: [
{
id: 'ai-subscription-codex',
title: (
<>
Codex
<SettingScopeTag scope="user" />
</>
),
searchTerm: 'Codex',
description:
'Connect your ChatGPT account so your Codex cloud tasks can run on your own ChatGPT plan. The connection is yours and applies in every project.',
component: <PersonalCodexIntegration />,
keywords: ['codex', 'chatgpt', 'openai', 'subscription', 'plan', 'billing', 'cloud', 'personal'],
},
],
},
{
level: 'environment',
id: 'environment-ai-subscriptions',
title: 'Subscriptions',
group: 'AI',
flag: ['POSTHOG_CODE_CODEX_OWN_SUBSCRIPTION_CLOUD', '!TODAY_RAIL_NAV'],
settings: [
{
id: 'ai-subscription-codex',
title: 'Codex',
description:
'Connect your ChatGPT account so your Codex cloud tasks can run on your own ChatGPT plan. The connection is yours and applies in every project.',
component: <PersonalCodexIntegration />,
keywords: ['codex', 'chatgpt', 'openai', 'subscription', 'plan', 'billing', 'cloud', 'personal'],
},
],
},
{
level: 'environment',
id: 'environment-task-agent-instructions',
title: 'Agent instructions',
group: 'AI',
flag: 'TODAY_RAIL_NAV',
keywords: ['custom instructions', 'personalization', 'simplified technical english', 'desktop'],
settings: [
{
id: 'task-agent-project-instructions',
title: (
<>
Project instructions
<SettingScopeTag scope="project" />
</>
),
searchTerm: 'Project instructions',
description:
'Instructions that PostHog cloud agents read as their AGENTS.md in every Tasks run on this project, including all Self-driving runs (scouts, research, and implementation) and scheduled runs. Use them for project conventions and for guidance that spans repositories, such as which repository owns which part of your product.',
component: <AgentProjectInstructionsSettings />,
keywords: ['ai', 'agent', 'agents.md', 'claude.md', 'instructions', 'tasks', 'cloud', 'project'],
},
{
id: 'task-agent-my-instructions',
title: (
<>
My instructions
<SettingScopeTag scope="user" />
</>
),
searchTerm: 'My instructions',
description:
'Instructions that PostHog cloud agents read after the project instructions in Tasks runs you start, from PostHog AI, Slack, or PostHog Desktop. Use them for your personal preferences and for anything you want agents to remember about how you work. Anyone who continues a task you started can see them, so leave out anything private. Self-driving and scheduled runs do not use them.',
component: <AgentPersonalInstructionsSettings />,
keywords: ['ai', 'agent', 'agents.md', 'claude.md', 'instructions', 'tasks', 'cloud', 'personal'],
},
],
},
{
level: 'environment',
id: 'environment-task-agent-instructions',
title: 'Agent instructions',
group: 'AI',
flag: '!TODAY_RAIL_NAV',
settings: [
{
id: 'task-agent-project-instructions',
title: 'Project instructions',
description:
'Instructions that PostHog cloud agents read as their AGENTS.md in every Tasks run on this project, including all Self-driving runs (scouts, research, and implementation) and scheduled runs. Use them for project conventions and for guidance that spans repositories, such as which repository owns which part of your product.',
component: <AgentProjectInstructionsSettings />,
keywords: ['ai', 'agent', 'agents.md', 'claude.md', 'instructions', 'tasks', 'cloud', 'project'],
},
{
id: 'task-agent-my-instructions',
title: 'My instructions',
description:
'Instructions that PostHog cloud agents read after the project instructions in Tasks runs you start, from PostHog AI, Slack, or PostHog Desktop. Use them for your personal preferences and for anything you want agents to remember about how you work. Anyone who continues a task you started can see them, so leave out anything private. Self-driving and scheduled runs do not use them.',
component: <AgentPersonalInstructionsSettings />,
keywords: ['ai', 'agent', 'agents.md', 'claude.md', 'instructions', 'tasks', 'cloud', 'personal'],
},
],
},
{
level: 'environment',
id: 'environment-ai-usage',
title: 'Usage',
group: 'AI',
flag: 'TODAY_RAIL_NAV',
keywords: ['plan & usage', 'cost management', 'spend', 'credits', 'billing'],
settings: [
{
id: 'ai-usage-spend',
title: (
<>
Your agent spend
<SettingScopeTag scope="user" />
</>
),
searchTerm: 'Your agent spend',
description: 'What your PostHog Desktop and cloud agent runs cost, across all your projects.',
component: <AgentUsageSettings />,
keywords: ['spend', 'cost', 'usage', 'credits', 'billing', 'models', 'desktop'],
hideOn: [Realm.SelfHostedClickHouse, Realm.SelfHostedPostgres],
},
],
},
{
level: 'environment',
id: 'environment-ai-cloud-environments',
title: 'Cloud environments',
group: 'AI',
flag: 'TODAY_RAIL_NAV',
keywords: ['environments', 'sandbox', 'network access', 'allowed domains', 'desktop'],
settings: [
{
id: 'ai-cloud-environments',
title: 'Environments',
description:
'Cloud runs start in a sandbox. An environment sets which repositories it applies to and which hosts the sandbox can reach.',
component: <CloudEnvironmentsSettings />,
keywords: ['sandbox', 'network', 'domains', 'firewall', 'repositories', 'cloud runs'],
},
{
id: 'ai-cloud-custom-images',
title: 'Custom images',
description:
'An image is a sandbox with your tools already installed. A builder agent sets it up from your description.',
component: <CloudImagesSettings />,
keywords: ['image', 'custom image', 'sandbox image', 'tools', 'dependencies', 'setup'],
},
],
},
{
level: 'environment',
id: 'posthog-mcp',
title: 'PostHog MCP',
group: 'AI',
settings: [
{
id: 'posthog-mcp-configure',
title: 'Model Context Protocol (MCP) server',
description:
'Connect PostHog to AI tools like Claude, Cursor, and Copilot via the MCP protocol for data-driven AI assistance.',
docsUrl: 'https://posthog.com/docs/model-context-protocol',
component: <MCPServerSettings />,
keywords: ['ai', 'llm', 'claude', 'cursor', 'copilot'],
},
],
},
{
level: 'environment',
id: 'mcp-analytics',
title: 'MCP analytics',
group: 'Products',
settings: [
{
id: 'mcp-analytics-custom-harnesses',
title: 'Custom harnesses',
description:
'Name your own MCP clients. Calls from a client whose name or User-Agent contains the text you enter show under your name instead of Other harnesses. Harness names are cached, so a change can take a few minutes to show.',
component: <McpCustomHarnessesSettings />,
keywords: ['mcp', 'harness', 'client', 'user agent', 'other harnesses'],
},
],
},
{
level: 'environment',
id: 'mcp-servers',
title: 'MCP servers',
group: 'AI',
flag: 'MCP_GATEWAY',
settings: [
{
id: 'mcp-servers-manage',
title: null,
component: <McpStoreSettings />,
keywords: ['mcp', 'server', 'install', 'oauth', 'ai', 'agent'],
},
],
},
{
level: 'environment',
id: 'environment-ai-observability',
title: 'AI observability',
group: 'Products',
settings: [
{
id: 'ai-observability-byok',
title: 'Bring your own key (BYOK)',
description:
'Add and manage provider API keys for AI observability features, including evaluations and playground.',
component: <LLMProviderKeysSettings />,
docsUrl: 'https://posthog.com/docs/ai-evals/evaluations',
keywords: ['llm', 'provider', 'api key', 'openai', 'anthropic', 'gemini', 'playground'],
},
{
id: 'ai-observability-parser-recipes',
title: 'Custom parsing',
description:
"Add recipes that normalize provider message shapes the built-in recipes don't cover. They apply when rendering traces.",
component: <ParserRecipesSettings />,
keywords: ['parser', 'recipe', 'normalize', 'trace', 'provider', 'custom parsing', 'content'],
},
],
},
{
level: 'environment',
id: 'environment-ai-gateway-dev-mode',
title: 'AI gateway developer mode',
group: 'Products',
settings: [
{
id: 'ai-gateway-dev-mode-team-usage',
title: 'Team usage',
description: 'Developer mode minting, spend, and activity per user over the last 30 days.',
component: <DevModeTeamUsage />,
staffOnly: true,
keywords: ['ai gateway', 'llm gateway', 'developer mode', 'phe_', 'spend', 'audit'],
},
],
},
{
level: 'environment',
id: 'environment-csp-reporting',
title: 'CSP reporting',
group: 'Products',
settings: [
{
id: 'csp-reporting',
title: 'CSP reporting',
description:
'Collect Content Security Policy violation reports to monitor and debug CSP issues on your site.',
component: <CSPReportingSettings />,
keywords: ['content security policy', 'csp', 'violation', 'security'],
},
],
},
{
level: 'environment',
id: 'environment-data-quality',
title: 'Data quality',
group: 'Products',
settings: [
{
id: 'data-quality-materialization-gate',
title: 'Materialization on failing checks',
description:
'When an error-severity check fails, the materialized view keeps serving its previous version instead of being replaced. Applies to every materialized view in this project.',
component: <DataQualityGateToggle />,
keywords: ['data quality', 'check', 'materialization', 'materialized view', 'block', 'gate'],
},
],
},
{
level: 'environment',
id: 'environment-customer-analytics',
title: 'Customer analytics',
flag: 'CUSTOMER_ANALYTICS',
group: 'Products',
settings: [
{
id: 'group-analytics',
title: 'Group analytics',
description: 'Configure group types for analyzing user behavior at the company or team level.',
docsUrl: 'https://posthog.com/docs/product-analytics/group-analytics',
component: <GroupAnalyticsConfig />,
keywords: ['company', 'organization', 'team', 'group type'],
},
{
id: 'customer-analytics-usage-metrics',
title: 'Usage metrics',
description: 'Configure which events and properties are tracked as usage metrics for your customers.',
component: <UsageMetricsConfig />,
flag: 'CUSTOMER_ANALYTICS',
keywords: ['usage', 'engagement', 'activity'],
},
{
id: 'customer-analytics-dashboard-events',
title: 'Dashboard events',
description: 'Configure which events appear on customer analytics dashboards.',
component: <CustomerAnalyticsDashboardEvents />,
flag: 'CUSTOMER_ANALYTICS',
keywords: ['dashboard', 'customer', 'events'],
},
{
id: 'customer-analytics-accounts',
title: 'Accounts',
description: 'Select which group type represents an account in customer analytics.',
component: <CustomerAnalyticsAccountConfig />,
flag: ['CUSTOMER_ANALYTICS', 'CUSTOMER_ANALYTICS_CSP'],
keywords: ['accounts', 'group', 'b2b'],
},
{
id: 'customer-analytics-track-rules',
title: 'Track rules',
description: 'Choose which active accounts appear in Customer analytics.',
component: <AccountTrackRules />,
flag: ['CUSTOMER_ANALYTICS', 'CUSTOMER_ANALYTICS_TRACK_RULES'],
keywords: ['accounts', 'track', 'ignore', 'rules', 'filter'],
},
{
id: 'customer-analytics-calendar-sync',
title: 'Google account sync',
description:
'Connect your Google account to sync customer meetings and email to matching accounts. Each team member connects their own account.',
component: <CalendarSyncConfig />,
flag: ['CUSTOMER_ANALYTICS', 'CUSTOMER_ANALYTICS_CSP'],
keywords: ['calendar', 'email', 'meetings', 'google', 'sync', 'accounts'],
},
{
id: 'customer-analytics-event-stream',
title: 'Notifications',
description: 'Configure your task digest emails and customer event stream for this project.',
component: <CustomerAnalyticsNotifications />,
flag: 'CUSTOMER_ANALYTICS',
keywords: ['notifications', 'email', 'digest', 'tasks', 'event', 'stream', 'live', 'slack', 'accounts'],
},
{
id: 'customer-analytics-person-properties',
title: 'Person properties',
description:
'Sync warehouse table columns onto matching people as person properties, and manage their schedule, backfills, and run history.',
component: <WarehousePersonPropertiesSetting />,
flag: 'WAREHOUSE_PERSON_PROPERTIES',
keywords: ['warehouse', 'person', 'properties', 'sync', 'backfill'],
},
{
id: 'customer-analytics-group-properties',
title: 'Group properties',
description:
'Sync warehouse table columns onto matching groups as group properties, and manage their schedule, backfills, and run history.',
component: <WarehouseGroupPropertiesSetting />,
flag: 'WAREHOUSE_PERSON_PROPERTIES',
keywords: ['warehouse', 'group', 'properties', 'sync', 'backfill'],
},
],
},
{
level: 'environment',
id: 'environment-error-tracking',
title: 'Error tracking',
group: 'Products',
accessControl: {
resourceType: AccessControlResourceType.ErrorTracking,
minimumAccessLevel: AccessControlLevel.Viewer,
},
settings: [
{
id: 'banner',
title: null,
component: <ErrorTrackingConfigurationMovedBanner />,
},
{
id: 'error-tracking-exception-autocapture',
title: 'Exception autocapture',
description:
'Automatically capture frontend exceptions using onError and onUnhandledRejection listeners in the web JavaScript SDK.',
docsUrl: 'https://posthog.com/docs/error-tracking',
platformSupport: FEATURE_SUPPORT.errorTrackingExceptionAutocapture,
component: <ExceptionAutocaptureToggle />,
keywords: ['crash', 'bug', 'exception', 'stack trace'],
},
{
id: 'error-tracking-integrations',
title: 'Integrations',
description: 'Connect error tracking with external services like GitHub or Linear.',
component: <ErrorTrackingIntegrations />,
keywords: ['github', 'linear', 'gitlab', 'jira', 'integration', 'connect', 'issue'],
},
],
},
{
level: 'environment',
id: 'environment-error-tracking-configuration',
title: 'Error tracking',
group: 'Products',
hideFromNavigation: true,
accessControl: {
resourceType: AccessControlResourceType.ErrorTracking,
minimumAccessLevel: AccessControlLevel.Viewer,
},
settings: [
{
id: 'error-tracking-general',
title: 'General',
component: <GeneralSettings />,
keywords: [
'kill switch',
'disable',
'stop',
'ingestion',
'drop',
'autocapture',
'crash',
'bug',
'exception',
'stack trace',
'adaptive',
'sampling',
],
},
{
id: 'error-tracking-alerting',
title: 'Alerting',
description: 'Configure alerts to get notified when new errors occur or error rates spike.',
component: <ErrorTrackingAlerting />,
keywords: ['notification', 'alert', 'threshold', 'spike'],
},
{
id: 'error-tracking-spike-detection',
title: 'Spike detection',
component: <SpikeDetectionSettings />,
},
{
id: 'error-tracking-rate-limits',
title: 'Rate limits',
component: <RateLimitSettings />,
flag: 'ERROR_TRACKING_RATE_LIMITING',
keywords: ['rate', 'limit', 'throttle', 'ingestion', 'cap', 'bypass'],
},
{
id: 'error-tracking-auto-assignment',
title: 'Assignment rules',
description: 'Automatically assign errors to team members based on rules you define.',
component: <AssignmentRules />,
keywords: ['assign', 'auto', 'owner', 'team', 'rule', 'routing'],
},
{
id: 'error-tracking-custom-grouping',
title: 'Grouping rules',
description: 'Define rules for how errors are grouped together into issues.',
component: <GroupingRules />,
keywords: ['group', 'custom', 'merge', 'fingerprint', 'dedup'],
},
{
id: 'error-tracking-severity-rules',
title: 'Severity rules',
description: 'Set the initial severity of new issues based on rules you define.',
component: <SeverityRules />,
keywords: ['severity', 'priority', 'triage', 'critical', 'rule'],
},
{
id: 'error-tracking-suppression-rules',
title: 'Suppression rules',
description: 'Filter out exceptions that match the given filters.',
component: <SuppressionRules />,
keywords: [
'filter',
'ignore',
'suppress',
'exception',
'type',
'message',
'automatic',
'bot',
'crawler',
'localhost',
'browser',
'hydration',
'chunk',
],
},
{
id: 'error-tracking-symbol-sets',
title: 'Symbol sets',
description: 'Upload source maps to get readable stack traces from minified code.',
docsUrl: 'https://posthog.com/docs/error-tracking/upload-source-maps',
component: <SymbolSets />,
keywords: ['source map', 'sourcemap', 'debug', 'minified', 'stack trace'],
},
{
id: 'error-tracking-releases',
title: 'Releases',
description: 'Track releases to see which version introduced errors and monitor deployment health.',
docsUrl: 'https://posthog.com/docs/error-tracking/releases',
component: <Releases />,
keywords: ['version', 'deploy', 'release', 'regression'],
},
],
},
{
level: 'environment',
id: 'environment-experiments',
title: 'Experiments',
group: 'Products',
settings: [
{
id: 'environment-experiment-stats-method',
title: 'Default statistical method',
description:
'Choose which statistical method to use by default for new experiments in this environment. Individual experiments can override this setting.',
docsUrl: 'https://posthog.com/docs/experiments',
component: <DefaultExperimentStatsMethod />,
keywords: ['bayesian', 'frequentist', 'statistics', 'ab test'],
},
{
id: 'environment-experiment-confidence-level',
title: 'Default confidence level',
description:
'Higher confidence level reduces false positives but requires more data. Can be overridden per experiment.',
component: <DefaultExperimentConfidenceLevel />,
keywords: ['confidence', 'significance', 'p-value', 'false positive'],
},
{
id: 'environment-experiment-mde',
title: 'Default minimum detectable effect',
description:
'The smallest effect size you want to detect with statistical significance. Lower values require more data and longer run times. Can be overridden per experiment.',
component: <DefaultMinimumDetectableEffect />,
keywords: ['mde', 'effect size', 'sensitivity', 'power', 'sample size'],
},
{
id: 'environment-experiment-recalculation-time',
title: 'Daily recalculation time',
description: (
<>
Select the time of day when experiment time series are recalculated. This time is in your
project's timezone (<ProjectTimezoneName />
).
</>
),
searchDescription:
"Select the time of day when experiment time series are recalculated. This time is in your project's timezone.",
component: <ExperimentRecalculationTime />,
keywords: ['schedule', 'refresh', 'update', 'time'],
flag: '!EXPERIMENT_MULTIPLE_RECALCULATION_TIMES',
},
{
id: 'environment-experiment-recalculation-time',
title: 'Daily recalculation times',
description: (
<>
Select up to two times of day when experiment time series are recalculated, at least 6 hours
apart. Times are in your project's timezone (<ProjectTimezoneName />
).
</>
),
searchDescription:
"Select up to two times of day when experiment time series are recalculated, at least 6 hours apart. Times are in your project's timezone.",
component: <ExperimentRecalculationTime />,
keywords: ['schedule', 'refresh', 'update', 'time'],
flag: 'EXPERIMENT_MULTIPLE_RECALCULATION_TIMES',
},
{
id: 'environment-experiment-matured-users',
title: 'Default conversion window filter',
description:
'When enabled, new experiments will only count participants whose full conversion window has elapsed. Can be overridden per experiment.',
component: <DefaultOnlyCountMaturedUsers />,
keywords: ['matured', 'conversion', 'window', 'filter'],
},
{
id: 'environment-experiment-cuped-enabled',
title: 'Default CUPED variance reduction',
description:
'When enabled, experiments will use CUPED variance reduction. CUPED uses pre-experiment data to detect significant effects faster on supported metrics. Can be overridden per experiment.',
component: <DefaultCupedEnabled />,
keywords: ['cuped', 'variance', 'reduction', 'pre-experiment', 'covariate'],
},
{
id: 'environment-experiment-cuped-lookback-days',
title: 'Default CUPED lookback window',
description: `Number of days before the experiment start to use as the pre-experiment window for CUPED. Must be between ${MIN_LOOKBACK_DAYS} and ${MAX_LOOKBACK_DAYS} days. Can be overridden per experiment.`,
component: <DefaultCupedLookbackDays />,
keywords: ['cuped', 'lookback', 'pre-experiment', 'covariate', 'window'],
},
{
id: 'environment-experiment-sequential-testing-enabled',
title: 'Default sequential testing',
description:
'When enabled, frequentist experiments will use sequential testing by default, producing always-valid p-values that are robust to peeking. Confidence intervals are wider in exchange. Only applies to the frequentist statistical method. Can be overridden per experiment.',
component: <DefaultSequentialTestingEnabled />,
keywords: ['sequential', 'peeking', 'always-valid', 'p-value', 'frequentist'],
},
{
id: 'environment-experiment-sequential-tuning-parameter',
title: 'Default sequential testing tuning parameter',
description:
'Roughly the sample size at which the always-valid confidence sequence is tightest. Set close to the expected total sample size of new experiments to minimize the width penalty. Can be overridden per experiment.',
component: <DefaultSequentialTuningParameter />,
keywords: ['sequential', 'tuning', 'parameter', 'rho', 'frequentist'],
},
],
},
{
level: 'environment',
id: 'environment-feature-flags',
title: 'Feature flags',
group: 'Products',
settings: [
{
id: 'feature-flags-interface',
title: 'Flag persistence',
description:
'When enabled, all new feature flags will have persistence enabled by default. This ensures consistent user experiences across authentication steps.',
docsUrl:
'https://posthog.com/docs/feature-flags/creating-feature-flags#persisting-feature-flags-across-authentication-steps',
component: <FlagPersistenceSettings />,
keywords: ['flag', 'persistence', 'authentication', 'consistent'],
},
{
id: 'feature-flag-confirmation',
title: 'Flag change confirmation',
description:
'Show a confirmation modal before saving changes to existing feature flags, helping prevent accidental changes to release conditions.',
component: <FlagChangeConfirmationSettings />,
keywords: ['confirmation', 'safety', 'change', 'release'],
},
{
id: 'feature-flag-require-tags',
title: 'Require tags',
description:
'Require every new feature flag to have at least one tag, and stop a tagged flag losing its last one, so flags stay attributable to a team or workstream. Flags created for surveys, experiments, early access features, product tours, and web experiments are exempt.',
component: <RequireFeatureFlagTags />,
keywords: ['tag', 'tags', 'require', 'governance'],
},
{
id: 'feature-flag-request-blocklist',
title: 'Blocked domains and IP addresses',
description:
'Feature flag requests from these domains or IP addresses get an empty response and are not billed. Use this when someone else uses your project token without permission.',
component: <FeatureFlagRequestBlocklist />,
keywords: ['block', 'blocklist', 'domain', 'ip', 'origin', 'abuse', 'token'],
},
{
id: 'feature-flag-require-evaluation-contexts',
title: 'Require evaluation contexts',
description:
'Require all new feature flags to have at least one evaluation context before they can be created, preventing flags that are not properly scoped.',
docsUrl: 'https://posthog.com/docs/feature-flags/evaluation-contexts',
flag: 'FLAG_EVALUATION_TAGS',
component: <RequireEvaluationContexts />,
keywords: ['evaluation', 'context', 'scope', 'require'],
},
{
id: 'feature-flag-default-evaluation-contexts',
title: 'Default evaluation contexts',
description:
'Automatically apply default evaluation context tags to newly created feature flags. Users can still modify them during flag creation.',
docsUrl: 'https://posthog.com/docs/feature-flags/evaluation-contexts',
component: <DefaultEvaluationContexts />,
keywords: ['evaluation', 'default', 'context', 'tag'],
},
{
id: 'feature-flag-default-release-conditions',
title: 'Default release conditions',
description:
'Automatically apply default release conditions to newly created feature flags. Users can still modify them during flag creation.',
component: <DefaultReleaseConditions />,
keywords: ['release', 'conditions', 'default', 'rollout', 'groups'],
},
{
id: 'feature-flag-evaluation-context-suggestions',
title: 'Evaluation context suggestions',
description:
'Manage which evaluation context names are suggested when scoping a feature flag. Hide stale or mistyped names from the suggestion list without affecting flags that already use them.',
docsUrl: 'https://posthog.com/docs/feature-flags/evaluation-contexts',
flag: 'FLAG_EVALUATION_TAGS',
component: <EvaluationContextSuggestions />,
keywords: ['evaluation', 'context', 'suggestion', 'hide', 'tag'],
},
{
id: 'feature-flag-secure-api-key',
title: 'Feature flags secure API key',
description:
'Deprecated. This key is still usable for local evaluation of feature flags or remote config settings, but new integrations should use a project secret API key with the feature_flag:read scope instead.',
docsUrl: 'https://posthog.com/docs/feature-flags/local-evaluation',
component: <FlagsSecureApiKeys />,
keywords: ['api key', 'secret', 'local evaluation', 'remote config'],
},
],
},
{
level: 'environment',
id: 'environment-heatmaps',
title: 'Heatmaps',
group: 'Products',
settings: [
{
id: 'heatmaps',
title: 'Heatmaps',
description:
'Capture general clicks, mouse movements, and scrolling to create heatmaps. No additional events are created. Heatmaps are generated based on overall mouse or touch positions, useful for understanding general user behavior.',
docsUrl: 'https://posthog.com/docs/toolbar/heatmaps',
platformSupport: FEATURE_SUPPORT.heatmaps,
component: <HeatmapsSettings />,
keywords: ['click map', 'scroll', 'rage click', 'mouse', 'touch'],
},
{
id: 'heatmap-screenshot-cookie',
title: 'Screenshot request cookie',
description:
'Heatmap backgrounds are screenshots of your site. Generate a value your screenshots send as a cookie, so bot protection can tell them apart from other headless browsers and allow them.',
docsUrl: 'https://posthog.com/docs/toolbar/heatmaps',
component: <HeatmapScreenshotCookieSettings />,
keywords: [
'waf',
'bot protection',
'firewall',
'cloudflare',
'screenshot',
'blocked',
'allowlist',
'cookie',
],
},
{
id: 'heatmaps-capture',
title: 'Heatmap capture URLs',
description: 'Choose which pages send heatmap data: every page, or only the URLs you list.',
docsUrl: 'https://posthog.com/docs/toolbar/heatmaps',
platformSupport: FEATURE_SUPPORT.heatmaps,
component: <HeatmapCaptureSettings />,
keywords: ['allow list', 'allowlist', 'url', 'capture', 'restrict'],
},
],
},
{
level: 'environment',
id: 'environment-logs',
title: 'Logs',
group: 'Products',
settings: [
{
id: 'logs',
title: 'Logs',
description:
'Automatically capture browser console logs and send them to the Logs product for analysis and debugging. This is separate from session replay console log capture.',
docsUrl: 'https://posthog.com/docs/logs',
platformSupport: FEATURE_SUPPORT.logsCapture,
component: <LogsCaptureSettings />,
keywords: ['log', 'capture', 'collect', 'ingest', 'console'],
},
{
id: 'logs-json-parse',
title: 'JSON parse logs',
description:
'Parse log lines that are valid JSON and add their fields as log attributes that can be used in filters.',
component: <LogsJsonParseSettings />,
flag: 'LOGS_SETTINGS_JSON',
keywords: ['json', 'parse', 'structured', 'format'],
},
{
id: 'logs-json-parse-attribute',
title: 'JSON parse log attribute',
description:
'Choose a log attribute containing JSON to make its nested fields available in filters. This works independently of JSON parse logs.',
docsUrl: 'https://posthog.com/docs/logs/logs-config',
component: <LogsJsonParseAttributeSettings />,
flag: 'LOGS_JSON_ATTRIBUTE_PARSING',
keywords: ['json', 'parse', 'attributes', 'nested', 'structured'],
},
{
id: 'logs-pii-scrub',
title: 'PII scrubbing',
description:
'Remove or mask common personally identifiable information from log payloads during ingestion.',
component: <LogsPiiScrubSettings />,
flag: 'LOGS_SETTINGS_PII_SCRUB',
keywords: ['pii', 'privacy', 'gdpr', 'redact', 'mask', 'scrub', 'sensitive'],
},
{
id: 'logs-distinct-id-attribute-key',
title: 'Link to person',
description: (
<>
The log attributes PostHog reads to identify which person a log belongs to. A log is linked when
any of these attributes matches one of the person's distinct IDs. Defaults to{' '}
<code>posthogDistinctId</code>, the key the JavaScript and React Native SDKs auto-attach. Add
keys only if your backend pipeline emits the person identifier under different attributes.
</>
),
searchDescription:
"The log attributes PostHog reads to identify which person a log belongs to. A log is linked when any of these attributes matches one of the person's distinct IDs. Defaults to posthogDistinctId, the key the JavaScript and React Native SDKs auto-attach. Add keys only if your backend pipeline emits the person identifier under different attributes.",
component: <LogsDistinctIdAttributeKeys />,
keywords: ['log', 'person', 'distinct', 'attribute', 'pivot', 'profile', 'link'],
},
{
id: 'logs-pattern-message-keys',
title: 'Pattern message extraction',
description:
'Choose which JSON keys provide the message used to group logs into patterns. Keys are matched literally at the top level, in order. This does not change the stored log body.',
component: <LogsPatternMessageKeys />,
keywords: ['log', 'pattern', 'message', 'extract', 'json', 'group'],
},
{
id: 'logs-session-id-attribute-keys',
title: 'Link to session',
description: (
<>
The log attributes PostHog reads to identify which session a log belongs to, checked in order
with the first match winning, followed by other common session ID attributes. Defaults to{' '}
<code>sessionId</code>, the key the JavaScript and React Native SDKs auto-attach. Add keys only
if your pipeline emits the session ID under different attributes.
</>
),
searchDescription:
'The log attributes PostHog reads to identify which session a log belongs to, checked in order with the first match winning, followed by other common session ID attributes. Defaults to sessionId, the key the JavaScript and React Native SDKs auto-attach. Add keys only if your pipeline emits the session ID under different attributes.',
component: <LogsSessionIdAttributeKeys />,
keywords: ['log', 'session', 'replay', 'attribute', 'link'],
},
{
id: 'logs-retention',
title: 'Retention',
description: (
<span>
How long to retain logs before they are automatically deleted.{' '}
<strong>Changes only affect the retention for new logs</strong>. You can only change this
setting at most once per 24 hours.
</span>
),
component: <LogsRetentionSettingsBlock />,
keywords: ['retention', 'storage', 'delete', 'ttl', 'rules', 'filter', 'keep', 'expire'],
},
{
id: 'logs-drop-rules',
title: 'Drop rules',
description:
'Drop matching log lines before storage using ordered rules. Rules run in ingestion order (after optional scrub and JSON parse).',
component: <LogsSamplingSection />,
keywords: ['drop', 'exclude', 'filter', 'rules', 'path', 'attribute', 'volume', 'noise'],
},
{
id: 'logs-metric-rules',
title: 'Log-based metrics',
description:
'Generate metrics from your logs at ingestion time. Metrics are computed before drop rules, so you can drop noisy logs and keep the trend.',
component: <LogsMetricRulesSection />,
flag: 'METRICS',
keywords: ['metric', 'metrics', 'log-based', 'generate', 'count', 'aggregate', 'logs to metrics'],
},
{
id: 'logs-alerting',
title: 'Alerting',
description: 'Configure alerts to get notified when log volumes breach thresholds.',
component: <LogsAlertingSection />,
keywords: ['notification', 'alert', 'threshold', 'logs'],
},
],
},
{
level: 'environment',
id: 'environment-marketing-analytics',
title: 'Marketing analytics',
flag: 'WEB_ANALYTICS_MARKETING',
group: 'Products',
settings: [
{
id: 'marketing-settings',
title: 'Marketing settings',
description: 'Configure tracking and attribution settings for marketing analytics.',
docsUrl: 'https://posthog.com/docs/web-analytics/marketing-analytics',
component: <MarketingAnalyticsSettingsWrapper />,
keywords: ['utm', 'attribution', 'campaign', 'channel', 'marketing'],
},
],
},
{
level: 'environment',
id: 'environment-product-analytics',
title: 'Product analytics',
group: 'Products',
settings: [
{
id: 'data-theme',
title: 'Chart color themes',
description: 'Customize the color palette used in charts and visualizations.',
component: <DataColorThemes />,
keywords: ['color', 'palette', 'chart', 'visualization'],
},
{
id: 'persons-on-events',
title: 'Person properties mode',
description:
'Choose the behavior of person property filters. For best performance, use person properties from the time of the event.',
component: <PersonsOnEvents />,
flag: '!SETTINGS_PERSONS_ON_EVENTS_HIDDEN', // Setting hidden for Cloud orgs created since June 2024
keywords: ['person', 'properties', 'join', 'query', 'performance'],
},
{
id: 'person-display-name',
title: 'Person display name',
description:
'Choose which person properties are used to display names in the UI (e.g. email, name, username).',
docsUrl: 'https://posthog.com/docs/data/persons',
component: <PersonDisplayNameProperties />,
keywords: ['name', 'email', 'identity', 'display'],
},
{
id: 'person-last-seen-at',
title: 'Person last seen tracking',
description:
'When enabled, PostHog tracks when each person was last active. The value updates hourly and is visible in the People list.',
docsUrl: 'https://posthog.com/docs/data/persons',
component: <PersonLastSeenAtEnabled />,
keywords: ['person', 'last seen', 'activity', 'tracking'],
},
{
id: 'path-cleaning',
title: 'Path cleaning rules',
description:
'Define regex rules to normalize URLs in path analysis. Useful for removing IDs or query parameters from paths.',
docsUrl: 'https://posthog.com/docs/product-analytics/paths#path-cleaning-rules',
component: <PathCleaningFiltersConfig />,
keywords: ['url', 'regex', 'normalize', 'path analysis'],
},
{
id: 'project-events-retention',
title: 'Events retention',
component: <ProjectEventsRetentionSetting />,
keywords: ['events', 'retention', 'deletion', 'delete', 'months', 'compliance'],
},
{
id: 'human-friendly-comparison-periods',
title: 'Human friendly comparison periods',
description:
'When comparing against a previous month or year, compare against the same day of the week instead of the same calendar date. A year comparison becomes 52 weeks, and a month comparison becomes 4 weeks.',
component: <HumanFriendlyComparisonPeriodsSetting />,
keywords: ['compare', 'period', 'week', 'month', 'year', 'seasonality'],
},
{
id: 'group-analytics',
title: 'Group analytics',
description: 'Configure group types for analyzing user behavior at the company or team level.',
docsUrl: 'https://posthog.com/docs/product-analytics/group-analytics',
component: <GroupAnalyticsConfig />,
flag: '!CUSTOMER_ANALYTICS',
keywords: ['company', 'organization', 'team', 'group type'],
},
{
id: 'persons-join-mode',
title: 'Persons join mode',
description:
'Choose how persons are joined to events. Do not change this setting unless you know what you are doing.',
component: <PersonsJoinMode />,
flag: 'SETTINGS_PERSONS_JOIN_MODE',
keywords: ['join', 'inner', 'left', 'personless'],
},
{
id: 'session-table-version',
title: 'Sessions table version',
description:
'Choose which version of the sessions table to use. V2 is faster but requires uuidv7 session IDs. Use auto unless you know what you are doing.',
component: <SessionsTableVersion />,
flag: 'SETTINGS_SESSION_TABLE_VERSION',
keywords: ['session', 'table', 'version', 'uuidv7'],
},
],
},
{
level: 'environment',
id: 'environment-revenue-analytics',
title: 'Revenue analytics',
group: 'Products',
accessControl: {
resourceType: AccessControlResourceType.RevenueAnalytics,
minimumAccessLevel: AccessControlLevel.Editor,
},
settings: [
{
// FIXME: remove from "Revenue definitions" page
id: 'revenue-base-currency',
title: 'Base currency',
description: 'Set the base currency for revenue analytics calculations.',
component: <BaseCurrency hideTitle />,
hideWhenNoSection: true,
keywords: ['money', 'currency', 'usd', 'eur'],
},
{
// FIXME: remove from "Revenue definitions" page
id: 'revenue-analytics-filter-test-accounts',
title: 'Filter out internal and test users from revenue analytics',
description: 'Exclude test accounts from revenue calculations and reports.',
component: <RevenueAnalyticsFilterTestAccountsConfiguration />,
keywords: ['test account', 'internal', 'exclude', 'filter', 'revenue'],
},
{
// FIXME: should not be in settings
id: 'revenue-analytics-events',
title: 'Revenue events',
description: 'Configure which events represent revenue-generating actions.',
docsUrl: 'https://posthog.com/docs/revenue-analytics',
component: <EventConfiguration />,
keywords: ['purchase', 'payment', 'subscription', 'charge'],
},
{
// FIXME: should not be in settings
id: 'revenue-analytics-external-data-sources',
title: 'External data sources',
description: 'Connect external data sources like Stripe for revenue tracking.',
component: <ExternalDataSourceConfiguration />,
keywords: ['stripe', 'import', 'sync', 'data warehouse'],
},
],
},
{
level: 'environment',
id: 'environment-replay',
title: 'Session replay',
group: 'Products',
settings: [
{
id: 'replay',
title: 'Session replay',
description:
'Watch recordings of how users interact with your web app to diagnose issues and understand user behavior.',
docsUrl: 'https://posthog.com/docs/session-replay',
component: <ReplayGeneral />,
keywords: ['recording', 'video', 'screen', 'session'],
},
{
id: 'replay-log-capture',
title: 'Log capture',
description: 'Capture browser console logs alongside session recordings to help debug issues.',
docsUrl: 'https://posthog.com/docs/session-replay/console-log-recording',
platformSupport: FEATURE_SUPPORT.sessionReplayLogCapture,
component: <LogCaptureSettings />,
keywords: ['console', 'log', 'debug', 'error'],
},
{
id: 'replay-canvas-capture',
title: 'Canvas capture',
description:
'Capture HTML canvas elements in session recordings. Useful for apps that render charts, games, or other canvas-based content.',
docsUrl: 'https://posthog.com/docs/session-replay/canvas-recording',
platformSupport: FEATURE_SUPPORT.sessionReplayCanvasCapture,
component: <CanvasCaptureSettings />,
keywords: ['canvas', 'webgl', 'drawing', 'chart'],
},
{
id: 'replay-triggers',
title: 'Recording conditions',
description:
'Control when recordings start and stop. Use URL triggers, event triggers, or sampling to manage recording volume.',
docsUrl: 'https://posthog.com/docs/session-replay/how-to-control-which-sessions-you-record',
component: <ReplayTriggers />,
keywords: ['trigger', 'url', 'event', 'sample', 'condition', 'filter'],
},
{
id: 'replay-masking',
title: 'Privacy and masking',
description:
'Choose what data gets masked in your session recordings. For more control, configure masking directly in your code.',
docsUrl: 'https://posthog.com/docs/session-replay/privacy',
platformSupport: FEATURE_SUPPORT.sessionReplayMasking,
component: <ReplayMaskingSettings />,
keywords: ['redact', 'sensitive', 'pii', 'hide', 'mask', 'privacy', 'gdpr'],
},
{
id: 'replay-network',
title: 'Network capture',
description:
'Capture network request timings alongside session recordings to identify slow or failing API calls.',
docsUrl: 'https://posthog.com/docs/session-replay/network-recording',
platformSupport: FEATURE_SUPPORT.sessionReplayCaptureRequests,
component: <ReplayNetworkCapture />,
keywords: ['xhr', 'fetch', 'api', 'request', 'response', 'performance'],
},
{
id: 'replay-network-headers-payloads',
title: 'Network headers & payloads',
description:
'Capture request and response headers and body content alongside network timings. Sensitive data is automatically scrubbed.',
docsUrl: 'https://posthog.com/docs/session-replay/network-recording',
platformSupport: FEATURE_SUPPORT.sessionReplayCaptureHeadersAndPayloads,
component: <ReplayNetworkHeadersPayloads />,
keywords: ['headers', 'payload', 'body', 'request', 'response'],
},
{
id: 'replay-authorized-domains',
title: 'Authorized domains for replay',
description:
'This setting is deprecated. Use URL triggers in recording conditions to control which domains are recorded.',
platformSupport: FEATURE_SUPPORT.sessionReplayAuthorizedDomains,
component: <ReplayAuthorizedDomains />,
allowForTeam: (t) => !!t?.recording_domains?.length,
keywords: ['domain', 'whitelist', 'allowlist'],
},
{
id: 'replay-retention',
title: 'Data retention',
description:
'Control how long your recordings are stored. Changes only affect the retention period for future recordings.',
component: <ReplayDataRetentionSettings />,
keywords: ['storage', 'retention', 'delete', 'days', 'months'],
},
{
id: 'replay-integrations',
title: 'Integrations',
description: 'Configure integrations to create and link issues from session replays.',
component: <ReplayIntegrations />,
keywords: ['integration', 'connect', 'third-party'],
},
],
},
{
level: 'environment',
id: 'environment-conversations',
title: 'Support',
group: 'Products',
settings: [
{
id: 'conversations-general',
title: 'General',
component: <GeneralSection />,
keywords: [
'conversation',
'ticket',
'message',
'support',
'general',
'api',
'domain',
'identity',
'secret',
'channel',
'widget',
'email',
'slack',
'teams',
'microsoft',
],
},
{
id: 'conversations-notifications',
title: 'Notifications',
description:
'We recommend setting up a workflow for fine-grained automation — Slack pings, SLA escalations, auto-tagging. For the basics, configure email or browser notifications.',
component: <NotificationsSection />,
allowForTeam: (t) => !!t?.conversations_enabled,
keywords: [
'conversation',
'ticket',
'message',
'support',
'notification',
'workflow',
'email',
'browser',
],
},
{
id: 'conversations-ai',
title: (
<>
AI agent
<LemonTag type="highlight" size="small" className="ml-1">
Beta
</LemonTag>
</>
),
description:
'Automatically generate AI-powered reply suggestions grounded in your business knowledge sources.',
component: <AISection />,
flag: 'PRODUCT_SUPPORT_AI_SUGGESTION_ORGS',
allowForTeam: (t) => !!t?.conversations_enabled,
keywords: ['ai', 'agent', 'suggestion', 'auto', 'reply', 'support', 'conversation', 'beta'],
},
{
id: 'conversations-imports',
title: (
<>
Imports
<LemonTag type="highlight" size="small" className="ml-1">
Beta
</LemonTag>
</>
),
description: 'Import historical support data from external tools into Support.',
component: <ZendeskImportSection />,
allowForTeam: (t) => !!t?.conversations_enabled,
keywords: ['import', 'zendesk', 'migrate', 'ticket', 'support', 'conversation'],
},
{
id: 'conversations-macros',
title: 'Macros',
description: 'Save replies you send often and insert them from a ticket.',
component: <MacrosSection />,
allowForTeam: (t) => !!t?.conversations_enabled,
keywords: ['macro', 'canned', 'reply', 'shortcut', 'template', 'support', 'conversation'],
},
],
},
{
level: 'environment',
id: 'environment-business-knowledge',
title: 'Business knowledge',
group: 'Products',
flag: 'PRODUCT_BUSINESS_KNOWLEDGE',
settings: [
{
id: 'business-knowledge-learn-from-support',
title: 'Self-learning',
description:
'When on, PostHog learns reusable answers from public human replies on resolved support tickets.',
component: <LearnFromSupportSetting />,
docsUrl: 'https://posthog.com/docs/business-knowledge/learn-from-support',
keywords: ['business', 'knowledge', 'support', 'learn', 'ticket', 'resolved', 'past', 'backfill'],
},
{
id: 'business-knowledge-github-repos',
title: 'GitHub repositories',
description:
'Let business knowledge read these repositories when answering a question. It searches file names and the README, then reads a file. It does not index the code.',
component: <GithubReposSetting />,
keywords: ['business', 'knowledge', 'github', 'repository', 'code'],
},
],
},
{
level: 'environment',
id: 'environment-surveys',
title: 'Surveys',
group: 'Products',
settings: [
{
id: 'surveys-interface',
title: 'Surveys',
description:
'Enable or disable surveys in your web application. When disabled, surveys will not be rendered automatically.',
docsUrl: 'https://posthog.com/docs/surveys',
platformSupport: FEATURE_SUPPORT.surveys,
component: <SurveyEnableToggle />,
keywords: ['popup', 'widget', 'feedback', 'nps', 'csat', 'enable'],
},
{
id: 'surveys-default-appearance',
title: 'Default survey appearance',
description:
'Configure the default look and feel for new surveys. Individual surveys can override these settings.',
docsUrl: 'https://posthog.com/docs/surveys/creating-surveys#customizing-the-look-and-feel',
component: <SurveyDefaultAppearance />,
keywords: ['appearance', 'style', 'theme', 'customization', 'popup'],
},
],
},
{
level: 'environment',
id: 'environment-tracing',
title: 'Tracing',
group: 'Products',
flag: 'TRACING',
settings: [
{
id: 'tracing-distinct-id-attribute-keys',
title: 'Link to person',
description: (
<>
The span attributes PostHog reads to identify which person a trace belongs to. A span is linked
when any of these attributes holds one of the person's distinct IDs. Defaults to{' '}
<code>posthogDistinctId</code>. Add keys only if your pipeline emits the person identifier under
different attributes.
</>
),
searchDescription:
"The span attributes PostHog reads to identify which person a trace belongs to. A span is linked when any of these attributes holds one of the person's distinct IDs. Defaults to posthogDistinctId. Add keys only if your pipeline emits the person identifier under different attributes.",
component: <TracingDistinctIdAttributeKeys />,
flag: 'TRACING_SESSION_PERSON_LINKS',
keywords: ['trace', 'span', 'person', 'distinct', 'attribute', 'pivot', 'profile', 'link'],
},
{
id: 'tracing-session-id-attribute-keys',
title: 'Link to session',
description: (
<>
The span attributes PostHog reads to identify which session a trace belongs to, checked in order
with the first match winning, followed by other common session ID attributes. Defaults to{' '}
<code>sessionId</code>. Add keys only if your pipeline emits the session ID under different
attributes.
</>
),
searchDescription:
'The span attributes PostHog reads to identify which session a trace belongs to, checked in order with the first match winning, followed by other common session ID attributes. Defaults to sessionId. Add keys only if your pipeline emits the session ID under different attributes.',
component: <TracingSessionIdAttributeKeys />,
flag: 'TRACING_SESSION_PERSON_LINKS',
keywords: ['trace', 'span', 'session', 'replay', 'attribute', 'link'],
},
{
id: 'tracing-retention',
title: 'Retention',
description: (
<span>
How long to keep spans before they are automatically deleted.{' '}
<strong>Changes only affect the retention for new spans</strong>. You can only change this
setting at most once per 24 hours.
</span>
),
component: <TracingRetentionSettingsBlock />,
flag: 'TRACING_SETTINGS_RETENTION',
keywords: ['retention', 'storage', 'delete', 'ttl', 'rules', 'filter', 'keep', 'expire', 'span'],
},
],
},
{
level: 'environment',
id: 'environment-web-analytics',
title: 'Web analytics',
group: 'Products',
settings: [
{
id: 'web-analytics-authorized-urls',
title: 'Web analytics domains',
description:
'Configure which domains are tracked in web analytics. Wildcards are not allowed — URLs must be concrete and launchable.',
component: <TeamAuthorizedURLs />,
keywords: ['domain', 'website', 'url'],
},
{
id: 'channel-type',
title: 'Custom channel type',
description: 'Define custom rules for categorizing traffic sources into channels.',
docsUrl: 'https://posthog.com/docs/data/channel-type',
component: <CustomChannelTypes />,
keywords: ['utm', 'source', 'medium', 'referrer', 'attribution'],
},
{
id: 'cookieless-server-hash-mode',
title: 'Cookieless tracking',
description:
'Count unique users with a privacy-preserving hash instead of cookies. Enable this here, then enable cookieless mode in posthog-js.',
docsUrl: 'https://posthog.com/tutorials/cookieless-tracking',
component: <CookielessServerHashModeSetting />,
keywords: ['cookie', 'privacy', 'gdpr', 'tracking', 'consent'],
},
{
id: 'bounce-rate-duration',
title: 'Bounce rate duration',
description:
'Set how long a user can stay on a page (in seconds) before the session is not counted as a bounce. Default is 10 seconds.',
docsUrl: 'https://posthog.com/tutorials/bounce-rate',
component: <BounceRateDurationSetting />,
keywords: ['bounce', 'session', 'duration', 'seconds'],
},
{
id: 'bounce-rate-page-view-mode',
title: 'Bounce rate page view mode',
description:
'Choose how pageviews are counted as part of the bounce rate calculation. Other factors like autocaptures and session duration are also considered.',
component: <BounceRatePageViewModeSetting />,
flag: 'SETTINGS_BOUNCE_RATE_PAGE_VIEW_MODE',
keywords: ['bounce', 'pageview', 'url', 'calculation'],
},
{
id: 'web-analytics-pre-aggregated-tables',
title: 'Pre-aggregated tables',
description: 'Configure pre-aggregated tables to speed up web analytics queries.',
component: <PreAggregatedTablesSetting />,
flag: 'SETTINGS_WEB_ANALYTICS_PRE_AGGREGATED_TABLES',
keywords: ['performance', 'speed', 'query', 'materialized'],
},
{
id: 'web-analytics-opt-in-pre-aggregated-tables-and-api',
title: 'New query engine',
description: 'Enable the new pre-aggregated query engine for faster web analytics.',
component: <WebAnalyticsEnablePreAggregatedTables />,
flag: 'WEB_ANALYTICS_API',
keywords: ['performance', 'speed', 'query', 'api'],
},
{
id: 'web-vitals-autocapture',
title: 'Web vitals autocapture',
description: "Capture Google Chrome's web vitals metrics for web analytics performance tracking.",
docsUrl: 'https://posthog.com/docs/web-analytics/web-vitals',
platformSupport: FEATURE_SUPPORT.webVitals,
component: <WebVitalsAutocaptureSettings />,
keywords: ['lcp', 'cls', 'fcp', 'inp', 'performance', 'core web vitals'],
},
],
},
{
level: 'environment',
id: 'environment-workflows',
title: 'Workflows',
group: 'Products',
settings: [
{
id: 'workflows-engagement-events',
title: 'Engagement events',
description:
'When enabled, email engagement activity (sent, delivered, opened, link clicked, bounced, blocked, failed) is captured as standard PostHog events alongside the existing workflow metrics. This lets you build insights, funnels, and dashboards from workflows data. These events count toward your event usage and are billed like any other event. This setting only controls event capture: it does not disable open and click tracking itself. To stop tracking opens and clicks for an email, turn off "Track opens and link clicks" on that email step.',
docsUrl: 'https://posthog.com/docs/workflows/engagement-events',
component: <WorkflowsEngagementEventsSettings />,
keywords: [
'workflows',
'email',
'engagement',
'events',
'capture',
'tracking',
'sent',
'delivered',
'opened',
'clicked',
'bounced',
'blocked',
'failed',
],
},
{
id: 'workflows-utm-defaults',
title: 'UTM tags on email links',
description:
'Default UTM tags for new broadcasts and workflow emails, so visits from your emails show up as their own campaigns in web analytics. Each email can still change them.',
component: <WorkflowsUtmDefaultsSettings />,
keywords: ['workflows', 'broadcasts', 'email', 'utm', 'campaign', 'links', 'web analytics'],
},
{
id: 'workflows-email-tracking-consent',
title: 'Email tracking consent',
description:
'Controls whether open and click tracking on marketing workflow emails requires recipient consent. Untracked emails contain no tracking pixel and no rewritten links, and never record opens or clicks. Transactional emails are exempt. Delivery, bounce, and unsubscribe events are always recorded.',
component: <WorkflowsEmailTrackingConsentSettings />,
keywords: [
'workflows',
'email',
'tracking',
'consent',
'pixel',
'cnil',
'gdpr',
'privacy',
'opt-in',
'opt-out',
],
},
{
id: 'workflows-frequency-cap',
title: 'Frequency cap',
description:
'The most marketing messages one person can get in a rolling number of days, across all workflows and broadcasts. Sends past the cap are skipped and the workflow moves on to the next step, unless you set a hold time. Then a send waits for the next free slot for that person. Transactional messages are never capped and do not count. A workflow run without a person, for example one triggered by an event without a person profile, is not capped. Leave both fields empty to turn the cap off.',
component: <WorkflowsFrequencyCapSettings />,
keywords: ['workflows', 'frequency', 'cap', 'limit', 'fatigue', 'marketing', 'broadcast', 'email'],
},
{
id: 'workflows-ai-task-limits',
title: 'AI task limits',
description:
'How many AI tasks your workflows can create in a rolling 24 hours. One limit applies to each workflow on its own, the other to every workflow in the project together. Leave a limit empty to use the default. Set it to zero to pause task creation. Contact support to raise a limit above 500 per workflow or 2,500 per project.',
component: (
<WorkflowsDailyLimitsSettings
perWorkflowField="workflow_task_rate_limit_per_day"
perProjectField="workflow_task_team_rate_limit_per_day"
defaultPerWorkflow={100}
defaultPerProject={500}
unit="tasks"
attrPrefix="workflows-task"
/>
),
keywords: ['workflows', 'ai', 'task', 'agent', 'limit', 'rate', 'cap', 'daily', 'spend', 'pause'],
},
{
id: 'workflows-replay-vision-limits',
title: 'Replay Vision scan limits',
description:
'How many Replay Vision scans your workflows can request in a rolling 24 hours. One limit applies to each workflow on its own, the other to every workflow in the project together. Leave a limit empty to use the default. Set it to zero to pause scans. Contact support to raise a limit above 500 per workflow or 2,500 per project.',
component: (
<WorkflowsDailyLimitsSettings
perWorkflowField="replay_vision_scan_rate_limit_per_day"
perProjectField="replay_vision_scan_team_rate_limit_per_day"
defaultPerWorkflow={100}
defaultPerProject={500}
unit="scans"
attrPrefix="workflows-replay-vision"
/>
),
keywords: ['workflows', 'replay', 'vision', 'scan', 'limit', 'rate', 'cap', 'daily', 'spend', 'pause'],
},
],
},
{
level: 'environment',
id: 'environment-access-control',
title: 'Access control',
settings: [
{
id: 'environment-access-control',
title: 'Access control',
description: 'Manage who has access to this project and what they can do.',
docsUrl: 'https://posthog.com/docs/settings/access-control',
component: <TeamAccessControl />,
keywords: ['permission', 'role', 'access', 'rbac', 'team'],
},
],
},
{
level: 'environment',
id: 'environment-activity-logs',
title: 'Activity logs',
payGate: {
feature: AvailableFeature.AUDIT_LOGS,
// pinned: `pay gate shown` property value, so renaming it breaks existing insights
featureDetail: 'activity-log-retention',
bypassForImpersonation: true,
},
settings: [
{
id: 'activity-log-settings',
title: 'Activity logs',
description: 'View a log of changes made to this environment by team members.',
component: <ActivityLogSettings />,
keywords: ['audit', 'history', 'change', 'activity'],
},
{
id: 'activity-log-org-level-settings',
title: 'Settings',
description: 'Configure organization-level activity log settings.',
component: <ActivityLogOrgLevelSettings />,
keywords: ['audit', 'organization', 'activity'],
},
{
id: 'activity-log-notifications',
title: 'Notifications',
description: 'Get notified about activity log events via configured destinations.',
component: <ActivityLogNotifications />,
allowForTeam: (t) => (t?.effective_membership_level ?? 0) >= OrganizationMembershipLevel.Admin,
keywords: ['notification', 'alert', 'activity', 'webhook'],
},
],
},
{
level: 'environment',
id: 'environment-approvals',
title: 'Approvals',
minimumAccessLevel: OrganizationMembershipLevel.Admin,
settings: [
{
id: 'approval-policies',
title: 'Policies',
description: 'Configure which actions require approval before being applied.',
docsUrl: 'https://posthog.com/docs/settings/approvals#policies',
component: <ApprovalPolicies />,
keywords: ['approval', 'policy', 'review', 'gate'],
},
{
id: 'change-requests',
title: 'Change requests',
description: 'Review and approve pending change requests.',
docsUrl: 'https://posthog.com/docs/settings/approvals#change-requests',
component: <ChangeRequestsList />,
keywords: ['approval', 'review', 'pending', 'request'],
},
],
},
{
level: 'environment',
id: 'environment-autocapture',
title: 'Autocapture',
settings: [
{
id: 'autocapture',
title: 'Autocapture',
description:
'Automatically capture frontend events such as clicks, input changes, and form submissions when using the web JavaScript SDK. Also available for React Native and iOS via code configuration.',
docsUrl: 'https://posthog.com/docs/product-analytics/autocapture',
platformSupport: FEATURE_SUPPORT.autocapture,
component: <AutocaptureSettings />,
keywords: ['click', 'input', 'form', 'dom', 'automatic', 'event'],
},
{
id: 'autocapture-data-attributes',
title: 'Data attributes',
description:
'Specify data attributes used in your app (e.g. data-attr, data-custom-id). These attributes help the toolbar and action definitions match unique elements on your pages. Use * as a wildcard.',
docsUrl: 'https://posthog.com/docs/product-analytics/autocapture#data-attributes',
component: <DataAttributes />,
keywords: ['selector', 'css', 'element', 'toolbar', 'action'],
},
{
id: 'web-vitals-autocapture',
title: 'Web vitals autocapture',
description:
"Capture Google Chrome's web vitals metrics (LCP, CLS, FCP, INP). These events enhance web analytics and session replay with performance data.",
docsUrl: 'https://posthog.com/docs/web-analytics/web-vitals',
platformSupport: FEATURE_SUPPORT.webVitals,
component: <WebVitalsAutocaptureSettings />,
keywords: ['lcp', 'cls', 'inp', 'fcp', 'performance', 'core web vitals'],
},
{
id: 'dead-clicks-autocapture',
title: 'Dead clicks autocapture',
description:
"Track clicks that don't result in any action (no scroll, text selection, or DOM mutation). Dead clicks help you find elements users expect to be interactive but aren't.",
docsUrl: 'https://posthog.com/docs/toolbar/heatmaps#dead-clicks',
platformSupport: FEATURE_SUPPORT.deadClicks,
component: <DeadClicksAutocaptureSettings />,
keywords: ['rage click', 'broken', 'unresponsive', 'frustration'],
},
],
},
{
level: 'environment',
id: 'environment-discussions',
title: 'Discussions',
settings: [
{
id: 'discussion-mention-integrations',
title: 'Integrations',
description: 'Configure how discussion mentions are delivered via integrations.',
component: <DiscussionMentionNotifications />,
allowForTeam: (t) => (t?.effective_membership_level ?? 0) >= OrganizationMembershipLevel.Admin,
keywords: ['mention', 'notification', 'comment', 'discussion'],
},
],
},
{
level: 'environment',
id: 'environment-exports',
title: 'Exports',
to: urls.exports(),
settings: [],
},
{
level: 'environment',
id: 'environment-integrations',
title: 'Integrations',
settings: [
{
id: 'integration-slack',
title: 'Slack integration',
description:
'Integrate with Slack to subscribe to insights or dashboards for regular reports to channels of your choice.',
docsUrl: Slack.docsUrl,
component: <Slack.SettingsSection connectSurface="settings" />,
keywords: ['slack', 'channel', 'notification', 'subscribe', 'report'],
},
{
id: 'integration-github',
title: 'GitHub integration',
description: 'Connect GitHub to link issues and pull requests with PostHog insights.',
docsUrl: GitHub.docsUrl,
component: <GitHub.SettingsSection connectSurface="settings" />,
keywords: ['github', 'git', 'repository', 'issue', 'pr'],
},
{
id: 'integration-gitlab',
title: 'GitLab integration',
description: 'Connect GitLab projects to create and link issues from PostHog.',
docsUrl: GitLab.docsUrl,
component: <GitLab.SettingsSection connectSurface="settings" />,
flag: 'WEB_GITLAB_INTEGRATION',
keywords: ['gitlab', 'git', 'repository', 'project', 'issue'],
},
{
id: 'integration-linear',
title: 'Linear integration',
description: 'Connect Linear to create and link issues directly from PostHog.',
docsUrl: Linear.docsUrl,
component: <Linear.SettingsSection />,
keywords: ['linear', 'issue', 'project management', 'task'],
},
{
id: 'integration-other',
title: 'Other integrations',
description:
'Integrations connected from other product areas, such as pipeline destinations, data warehouse sources, error tracking, and marketing analytics.',
component: <OtherIntegrationsSettings />,
keywords: ['integration', 'connect', 'third-party', 'app'],
},
{
id: 'integration-ip-allowlist',
title: 'Static IP addresses',
description:
'PostHog Cloud uses static IP addresses for outbound traffic. Add these to your firewall allowlist if needed.',
component: <IPAllowListInfo />,
keywords: ['whitelist', 'firewall', 'allowlist', 'cidr', 'ip'],
},
],
},
{
level: 'environment',
id: 'environment-privacy',
title: 'Privacy',
settings: [
{
id: 'datacapture',
title: 'IP data capture configuration',
description:
'When enabled, client IP addresses will not be stored with your events. Transformations like GeoIP enrichment and bot detection can still use the IP before it is discarded. Note: this does not apply when Cookieless server hash mode is enabled, which strips the IP before transformations run.',
docsUrl: 'https://posthog.com/docs/privacy',
component: <IPCapture />,
keywords: ['ip', 'anonymize', 'gdpr', 'privacy', 'geolocation', 'discard'],
},
],
},
{
level: 'environment',
id: 'environment-secret-api-keys',
title: 'Project secret API keys',
settings: [
{
id: 'environment-secret-api-keys',
title: 'Project secret API keys',
description:
'These keys allow access to a select set of API endpoints, intended to be accessed exclusively by your systems. Only give keys the permissions they need, and delete unused keys promptly.',
docsUrl: 'https://posthog.com/docs/api',
component: <ProjectSecretAPIKeys />,
keywords: ['token', 'api key', 'authentication', 'secret'],
},
],
},
{
level: 'environment',
id: 'environment-trusted-workloads',
title: 'Trusted workloads',
minimumAccessLevel: OrganizationMembershipLevel.Admin,
settings: [
{
id: 'environment-trusted-workloads',
title: 'Trusted workloads',
description:
'Let workloads you trust, such as CI jobs, get short-lived tokens for this project without storing a secret.',
component: <WorkloadTrustPolicies />,
keywords: [
'workload',
'workload identity',
'federation',
'ci',
'oidc',
'github actions',
'gitlab',
'token',
'trust policy',
'deploy',
],
},
],
},
{
level: 'environment',
id: 'environment-danger-zone',
title: 'Danger zone',
settings: [
{
id: 'project-move',
title: 'Move project',
description: 'Move this project to a different organization.',
component: <ProjectMove />,
keywords: ['transfer', 'move', 'organization'],
},
{
id: 'environment-delete',
title: 'Delete environment',
description: 'Permanently delete this environment and all its data. This action cannot be undone.',
component: <ProjectDangerZone />,
keywords: ['delete', 'remove', 'destroy'],
},
],
},
// ORGANIZATION
{
level: 'organization',
id: 'organization-details',
title: 'General',
settings: [
{
id: 'organization-admin-notice',
title: null,
component: (
<LemonBanner type="info" className="my-4">
You must be an organization admin or owner to change these settings.
</LemonBanner>
),
},
{
id: 'organization-display-name',
title: 'Name & logo',
description:
"Your organization's name and logo are shown across the PostHog interface. Click the avatar to upload a custom logo.",
component: <OrganizationDisplayName />,
keywords: ['name', 'rename', 'label', 'organization', 'logo', 'image', 'brand', 'icon', 'avatar'],
},
{
id: 'organization-id',
title: 'Organization ID',
description: "Your organization's unique identifier, used in the PostHog API.",
component: <OrganizationVariables />,
keywords: ['organization', 'id', 'uuid', 'identifier', 'copy'],
},
{
id: 'organization-ai-consent',
title: 'AI service providers',
description: (
<>
PostHog AI features, such as the PostHog AI chat, use{' '}
<Tooltip title={getExternalAIProvidersTooltipTitle()}>
<dfn>external AI services</dfn>
</Tooltip>{' '}
for data analysis.
<br />
This <i>can</i> involve transfer of identifying user data, so we ask for your org-wide consent
below.
<br />
<strong>Your data will not be used for training third-party models.</strong>
<br />
<br />
<AIHipaaDisclaimer />
</>
),
component: <OrganizationAI />,
keywords: [
'ai',
'max',
'llm',
'artificial intelligence',
'consent',
'approve',
'enable',
'opt-in',
'data sharing',
],
searchDescription:
'PostHog AI features use external AI services for data analysis. This can involve transfer of identifying user data.',
},
{
id: 'organization-desktop-beta-terms',
title: 'PostHog Desktop beta terms',
description: (
<>
Accept the additional data-processing terms for the PostHog Desktop beta.
<br />
<br />
PostHog Desktop uses Baseten and Modal to process customer data, personal data, and PII. They
are not currently listed as PostHog subprocessors for this feature.
<br />
<br />
Your organization agrees to proceed notwithstanding that status. If this feature becomes
generally available, PostHog will update the DPA and provide notice. This beta may change or be
discontinued.
<br />
<br />
<Link to="https://posthog.com/subprocessors" target="_blank">
View PostHog subprocessors
</Link>
</>
),
component: <OrganizationDesktopBetaTerms />,
keywords: ['desktop', 'beta', 'terms', 'consent', 'opt-in', 'data processing'],
searchDescription: 'Accept the additional data-processing terms for the PostHog Desktop beta.',
},
{
id: 'organization-ai-training-opt-out',
title: 'Internal AI training',
component: <OrganizationAITrainingOptOut />,
hideOn: [Realm.SelfHostedClickHouse, Realm.SelfHostedPostgres],
keywords: ['ai', 'training', 'opt-out', 'opt-in', 'model', 'max'],
searchDescription:
'Control whether PostHog can use your data to train AI models. Turning this off disables AI features for your organization.',
},
{
id: 'organization-ip-anonymization-default',
title: 'IP data capture default',
description:
'When enabled, new projects will automatically have "Discard client IP data" turned on. This is recommended for GDPR compliance. Existing projects are not affected.',
component: <OrgIPAnonymizationDefault />,
keywords: ['ip', 'anonymize', 'gdpr', 'privacy', 'geolocation'],
},
{
id: 'organization-events-retention',
title: 'Events retention',
component: <OrganizationEventsRetentionSetting />,
keywords: ['events', 'retention', 'deletion', 'delete', 'months', 'compliance'],
},
{
id: 'organization-member-notice',
title: 'Member notice',
description:
'Show a message to every member of your organization at the top of each page, with an optional link button. Use it for things like a data policy or a compliance disclaimer.',
component: <OrganizationMemberNotice />,
keywords: [
'notice',
'banner',
'announcement',
'message',
'disclaimer',
'policy',
'compliance',
'legal',
],
},
],
},
{
level: 'organization',
id: 'organization-authentication',
title: 'Authentication',
settings: [
{
id: 'authentication-domains',
title: 'Authentication Domains',
docsUrl: 'https://posthog.com/docs/settings/sso',
component: <VerifiedDomains />,
keywords: ['sso', 'saml', 'single sign-on', 'domain verification', 'enforce'],
},
{
id: 'enforce-verified-domains',
title: 'Domain enforcement',
component: <EnforceVerifiedDomains />,
keywords: ['sso', 'verified domain', 'restrict', 'membership', 'invites'],
},
{
id: 'saml-configuration',
title: 'SAML single sign-on',
description:
'Authenticate members through your identity provider using Security Assertion Markup Language (SAML).',
docsUrl: 'https://posthog.com/docs/data/sso#setting-up-saml',
component: <IdentityProviderFeatureSection configScope={ConfigScopeEnumApi.Saml} />,
flag: 'SSO_SETTINGS_REDESIGN',
keywords: ['sso', 'saml', 'single sign-on', 'identity provider'],
},
{
id: 'oidc-configuration',
title: 'OIDC single sign-on',
description: 'Authenticate members through your identity provider with OpenID Connect (OIDC).',
component: <IdentityProviderFeatureSection configScope={ConfigScopeEnumApi.Oidc} />,
flag: 'SSO_SETTINGS_REDESIGN',
keywords: ['sso', 'oidc', 'openid connect', 'single sign-on', 'identity provider'],
},
{
id: 'scim-configuration',
title: 'SCIM provisioning',
description:
'Provision and deprovision organization members through your identity provider using System for Cross-domain Identity Management (SCIM).',
docsUrl: 'https://posthog.com/docs/data/sso#setting-up-scim',
component: <IdentityProviderFeatureSection configScope={ConfigScopeEnumApi.Scim} />,
flag: 'SSO_SETTINGS_REDESIGN',
keywords: ['scim', 'provisioning', 'identity provider'],
},
{
id: 'xaa-configuration',
title: 'XAA authentication',
description: 'Automate API and MCP access to PostHog with Cross App Access (XAA).',
docsUrl: 'https://posthog.com/docs/settings/id-jag',
component: <IdentityProviderFeatureSection configScope={ConfigScopeEnumApi.Xaa} />,
flag: ['SSO_SETTINGS_REDESIGN', 'XAA_AUTHENTICATION'],
keywords: ['xaa', 'id-jag', 'identity provider', 'token exchange'],
},
],
},
{
level: 'organization',
id: 'organization-billing',
hideSelfHost: true,
title: 'Billing',
to: urls.organizationBilling(),
settings: [],
keywords: ['usage', 'subscription', 'invoice', 'plan', 'payment', 'spend', 'quota', 'credits', 'card'],
},
{
level: 'organization',
id: 'organization-cimd-verification-tokens',
title: 'CIMD verification tokens',
settings: [
{
id: 'organization-cimd-verification-tokens-list',
title: 'CIMD verification tokens',
description: 'Link CIMD partner applications to this organization for higher rate limits and identity.',
component: <CIMDVerificationTokens />,
keywords: ['cimd', 'oauth', 'partner', 'provisioning', 'verification', 'token', 'api', 'rate limit'],
},
],
},
{
level: 'organization',
id: 'organization-integrations',
title: 'Integrations',
settings: [
{
id: 'organization-integrations-list',
title: 'Connected integrations',
description: 'Manage integrations connected at the organization level.',
component: <OrganizationIntegrations />,
keywords: ['integration', 'connect', 'third-party', 'oauth'],
},
],
},
{
level: 'organization',
id: 'organization-legal-documents',
hideSelfHost: true,
title: 'Legal documents',
to: urls.legalDocuments(),
settings: [],
minimumAccessLevel: OrganizationMembershipLevel.Admin,
},
{
level: 'organization',
id: 'organization-proxy',
title: 'Managed reverse proxy',
settings: [
{
id: 'organization-proxy',
title: 'Managed reverse proxies',
docsUrl: 'https://posthog.com/docs/advanced/proxy',
component: <ManagedReverseProxy />,
keywords: ['custom domain', 'dns', 'cname', 'ad blocker', 'first party'],
},
],
},
{
level: 'organization',
id: 'organization-members',
title: 'Members',
settings: [
{
id: 'invites',
title: 'Pending invites',
description: 'Manage pending invitations to join your organization.',
component: <Invites />,
keywords: ['invite', 'email', 'pending', 'join'],
},
{
id: 'members',
title: 'Organization members',
description: 'View and manage current members of your organization and their roles.',
component: <Members />,
keywords: ['member', 'user', 'role', 'admin', 'owner'],
},
{
id: 'member-notifications',
title: 'Member notifications',
description:
'Choose which email notifications your members receive. Anything you set here they cannot change back themselves.',
component: <NotificationGovernanceSetting />,
organizationAdminOnly: true,
keywords: ['notification', 'email', 'member', 'lock', 'digest', 'pipeline'],
},
],
},
{
level: 'organization',
id: 'organization-oauth-apps',
title: 'OAuth applications',
settings: [
{
id: 'organization-oauth-apps-list',
title: 'OAuth applications',
description: 'View applications that have been authorized to connect to your organization.',
component: <OAuthApps />,
keywords: ['oauth', 'app', 'client', 'integration', 'api', 'authentication', 'third-party'],
},
],
},
{
level: 'organization',
id: 'organization-roles',
title: 'Roles',
settings: [
{
id: 'organization-roles',
title: 'Roles',
description:
'Use roles to group members across your organization for access control and issue assignment in Error tracking.',
docsUrl: 'https://posthog.com/docs/settings/access-control',
component: <RolesAccessControls />,
keywords: ['role', 'permission', 'rbac', 'access control'],
},
{
id: 'organization-default-role',
title: 'Default role for new members',
description:
'Automatically assign a role to new members when they join the organization. New users will inherit all permissions from this role.',
component: <DefaultRoleSelector />,
keywords: ['default', 'role', 'new member', 'onboarding'],
},
],
},
{
level: 'organization',
id: 'organization-access-resolution',
title: 'Access resolution preview',
flag: 'ACCESS_CONTROL_RESOLUTION_PREVIEW',
// Temporary migration surface: reachable only from the access control
// settings banner, never from the settings navigation or search
hideFromNavigation: true,
unavailableFallback: { sectionId: 'organization-roles', label: 'Go to access control settings' },
settings: [
{
id: 'organization-access-resolution-preview',
title: 'Access resolution preview',
description:
'PostHog is changing how access levels combine: the most specific rule will decide, instead of the highest one. Review what will be different for your organization before the change takes effect.',
component: <AccessResolutionPreview />,
keywords: ['access control', 'resolution', 'rbac', 'permission', 'override'],
},
],
},
{
level: 'organization',
id: 'organization-security',
title: 'Security',
minimumAccessLevel: OrganizationMembershipLevel.Admin,
settings: [
{
id: 'organization-security',
title: 'Security',
description: 'Configure organization-wide security policies.',
component: <OrganizationSecuritySettings />,
keywords: ['compliance', 'sharing', 'public'],
},
{
id: 'organization-mcp-access',
title: 'MCP access',
description: 'Control what the PostHog MCP can do in this organization.',
component: <OrganizationMCPAccess />,
keywords: ['mcp', 'ai', 'agent', 'read-only', 'model context protocol'],
},
{
id: 'organization-personal-api-keys',
title: 'Personal API key access',
description:
"See which members' personal API keys can reach this organization or its projects, who owns them, and the scopes they grant.",
component: <OrganizationPersonalAPIKeys />,
keywords: ['api key', 'personal', 'token', 'access', 'audit'],
},
],
},
{
level: 'organization',
id: 'organization-ssf',
hideSelfHost: true,
title: 'SSF',
settings: [
{
id: 'organization-ssf',
title: 'Shared Signals Framework (SSF)',
component: <SSFSetting />,
keywords: ['ssf', 'shared signals framework', 'security', 'signals', 'closed beta'],
},
],
},
{
level: 'organization',
id: 'organization-startup-program',
hideSelfHost: true,
title: 'Startup program',
to: urls.startups(),
settings: [],
minimumAccessLevel: OrganizationMembershipLevel.Admin,
flag: 'STARTUP_PROGRAM_INTENT',
},
{
level: 'organization',
id: 'organization-danger-zone',
title: 'Delete organization',
settings: [
{
id: 'organization-delete',
title: 'Delete organization',
description:
'Permanently delete your organization and all its projects and data. This action cannot be undone.',
component: <OrganizationDangerZone />,
keywords: ['delete', 'remove', 'destroy'],
},
],
},
// USER
{
level: 'user',
id: 'user-profile',
title: 'Profile',
settings: [
{
id: 'profile-picture',
title: 'Profile picture',
component: <ProfilePictureSettings />,
keywords: ['avatar', 'gravatar', 'photo', 'picture', 'image', 'profile'],
},
{
id: 'details',
title: 'Details',
component: <UserDetails />,
keywords: ['name', 'email', 'profile', 'personal'],
},
{
id: 'change-password',
title: <ChangePasswordTitle />,
component: <ChangePassword />,
keywords: ['password', 'security', 'credential'],
},
{
id: '2fa',
title: 'Two-factor authentication',
description: 'Add an extra layer of security to your account using an authenticator app or passkeys.',
component: <TwoFactorSettings />,
keywords: ['two-factor', 'mfa', 'authenticator', 'security', 'totp'],
},
{
id: 'passkeys',
title: 'Passkeys',
description: 'Manage your passkeys for passwordless sign-in and two-factor authentication.',
component: <PasskeySettings />,
keywords: ['webauthn', 'fido', 'biometric', 'passwordless'],
},
{
id: 'login-sessions',
title: 'Web sessions',
description: 'Devices and browsers currently signed in to your PostHog account.',
component: <LoginSessions />,
keywords: ['sessions', 'devices', 'logins', 'sign out', 'log out', 'security', 'revoke'],
},
],
},
{
level: 'user',
id: 'user-connected-apps',
title: 'Connected applications',
settings: [
{
id: 'connected-apps',
title: 'Connected applications',
description:
'Applications that have been granted access to your PostHog account via OAuth. You can revoke access at any time.',
component: <ConnectedApps />,
keywords: ['oauth', 'app', 'connected', 'authorized', 'revoke', 'access', 'token'],
},
],
},
{
level: 'user',
id: 'user-ai-gateway-dev-mode',
title: 'AI gateway developer mode',
settings: [
{
id: 'ai-gateway-dev-mode',
title: 'Developer mode tokens',
description: 'AI gateway tokens for PostHog staff.',
component: <DevModeSetting />,
staffOnly: true,
keywords: ['ai gateway', 'llm gateway', 'token', 'developer mode', 'phe_'],
},
],
},
{
level: 'user',
id: 'user-customization',
title: 'Customization',
settings: [
{
id: 'theme',
title: 'Theme',
component: <ThemeSwitcher onlyLabel />,
keywords: ['dark mode', 'light mode', 'appearance', 'color scheme'],
},
{
id: 'optout',
title: 'Anonymize data collection',
description:
'PostHog uses PostHog to capture information about how people use the product. Anonymize your usage data if you prefer not to share it.',
component: <OptOutCapture />,
hideOn: [Realm.Cloud],
keywords: ['telemetry', 'opt out', 'privacy', 'tracking'],
},
{
id: 'allow-impersonation',
title: 'Support access',
component: <AllowImpersonation />,
flag: 'CONTROL_SUPPORT_LOGIN',
keywords: ['impersonation', 'support login', 'debug'],
},
{
id: 'web-analytics-achievements',
title: 'Web analytics achievements',
description:
'Show playful achievement badges and streaks on the Web analytics dashboard. Applies to your current project.',
component: <WebAnalyticsAchievementsSetting />,
flag: 'WEB_ANALYTICS_ACHIEVEMENTS',
keywords: ['web analytics', 'achievements', 'gamification', 'badges', 'streak'],
},
{
id: 'hedgehog-mode',
title: 'Hedgehog mode',
description: 'Enable the PostHog hedgehog companion that follows you around the app.',
component: <HedgehogModeSettings />,
keywords: ['hedgehog', 'mascot', 'fun', 'companion', 'hog'],
},
{
id: 'customization-irl',
title: 'Customization IRL',
component: (
<div>
Grab some{' '}
<Link to="https://posthog.com/merch" target="_blank">
PostHog merch
</Link>{' '}
to customize yourself outside of the app
</div>
),
},
],
},
{
level: 'user',
id: 'user-feature-previews',
title: 'Feature previews',
settings: [
{
id: 'feature-previews',
title: 'Feature previews',
description:
'Try out upcoming PostHog features before they are generally available. Toggling a preview enables it for your account only.',
component: <FeaturePreviews />,
keywords: ['beta', 'early access', 'preview', 'opt-in'],
},
{
id: 'feature-previews-coming-soon',
title: 'Coming soon',
description: 'Get notified when upcoming features are ready for preview.',
component: <FeaturePreviewsComingSoon />,
keywords: ['upcoming', 'notify', 'concept', 'future'],
},
],
},
{
level: 'user',
id: 'user-notifications',
title: 'Notifications',
settings: [
{
id: 'notifications',
title: 'Notifications',
description: 'Choose which email notifications you receive from PostHog.',
component: <UpdateEmailPreferences />,
keywords: ['email', 'notification', 'digest', 'unsubscribe'],
},
{
id: 'realtime-notifications',
title: 'In-app notifications',
description: 'Choose which real-time notifications you receive in the PostHog app, per project.',
component: <RealtimeNotificationPreferences />,
flag: 'REAL_TIME_NOTIFICATIONS',
keywords: ['notification', 'in-app', 'realtime', 'popover', 'mention'],
},
{
id: 'task-comments-slack-dm',
title: 'Agent tasks',
description:
'Get a Slack direct message when someone mentions you, replies to your comment, or comments on a task you own.',
component: <TaskCommentSlackNotifications />,
flag: 'TODAY_RAIL_NAV',
keywords: ['slack', 'dm', 'direct message', 'comments', 'tasks', 'desktop', 'notifications'],
},
],
},
{
level: 'user',
id: 'user-api-keys',
title: 'Personal API keys',
settings: [
{
id: 'personal-api-keys',
title: 'Personal API keys',
description:
'These keys allow full access to your personal account through the API. Only give keys the permissions they need, and delete unused keys promptly.',
docsUrl: 'https://posthog.com/docs/api',
component: <PersonalAPIKeys />,
keywords: ['token', 'api key', 'authentication', 'secret'],
},
],
},
{
level: 'user',
id: 'user-personal-integrations',
title: 'Personal integrations',
settings: [
{
id: 'personal-integrations-github',
title: 'GitHub',
description:
'Your personal GitHub integrations for repo access, code attribution, and pull request authorship. You can connect multiple GitHub accounts or organizations.',
component: <PersonalGitHubIntegrations />,
keywords: ['github', 'integration', 'repos', 'identity', 'link', 'code', 'personal'],
},
{
id: 'personal-integrations-slack',
title: 'Slack',
description:
'Bind your Slack identity to this PostHog account so @PostHog mentions route to you even when your Slack email and PostHog email differ.',
component: <PersonalSlackIntegrations />,
keywords: ['slack', 'integration', 'identity', 'link', 'mention', 'personal'],
},
{
id: 'personal-integrations-posthog',
title: 'PostHog project',
description:
'Connect another PostHog project (in another region or your own) to act in it through its API, for example to dispatch tasks that must run there.',
component: <PersonalPosthogConnections />,
keywords: ['posthog', 'integration', 'connect', 'region', 'cross-region', 'task', 'personal'],
flag: 'POSTHOG_CONNECT',
},
],
},
{
level: 'user',
id: 'user-reminders',
title: 'Reminders',
settings: [
{
id: 'reminders',
title: 'Reminders',
description: 'Schedule one-off or recurring nudges that notify you in-app when they are due.',
component: <Reminders />,
keywords: ['reminder', 'notification', 'schedule', 'recurring', 'cron'],
},
],
},
{
level: 'user',
id: 'user-danger-zone',
title: 'Delete account',
settings: [
{
id: 'user-delete',
title: 'Delete account',
description: 'Permanently delete your PostHog account. This action cannot be undone.',
component: <UserDangerZone />,
keywords: ['delete', 'remove', 'account'],
},
],
},
]