: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 './FeatureFlag.scss'
import { useActions, useValues } from 'kea'
import { IconCode, IconFlag, IconGlobe, IconLaptop, IconList, IconPencil, IconServer } from '@posthog/icons'
import { LemonButton, LemonSwitch, LemonTag } from '@posthog/lemon-ui'
import { AccessControlAction } from 'lib/components/AccessControlAction'
import { ObjectTags } from 'lib/components/ObjectTags/ObjectTags'
import ViewRecordingsPlaylistButton from 'lib/components/ViewRecordingButton/ViewRecordingsPlaylistButton'
import { FEATURE_FLAGS } from 'lib/constants'
import { featureFlagLogic as enabledFeaturesLogic } from 'lib/logic/featureFlagLogic'
import { AccessControlLevel, AccessControlResourceType, FeatureFlagEvaluationRuntime, FeatureFlagType } from '~/types'
import { deletedCohortDisabledReason } from 'products/feature_flags/frontend/deletedCohortFilters'
import {
UNSUPPORTED_CONFIG_DISABLED_REASON,
featureFlagConfigFormat,
isRulesV2FeatureFlagConfig,
isV1FeatureFlagConfig,
} from 'products/feature_flags/frontend/featureFlagConfigFormat'
import { FeatureFlagConfigReadonlyNotice } from 'products/feature_flags/frontend/FeatureFlagConfigReadonlyNotice'
import { FeatureFlagImplementationPanel } from 'products/feature_flags/frontend/FeatureFlagImplementationPanel'
import { FeatureFlagRulesV2Readonly } from 'products/feature_flags/frontend/FeatureFlagRulesV2Readonly'
import { EditableOverviewSection } from './EditableOverviewSection'
import { FeatureFlagEvaluationContexts } from './FeatureFlagEvaluationContexts'
import { featureFlagLogic } from './featureFlagLogic'
import { FeatureFlagReleaseConditionsReadonly } from './FeatureFlagReleaseConditionsReadonly'
import { FeatureFlagVariantsSection } from './FeatureFlagVariantsSection'
import { JSONEditorInput } from './JSONEditorInput'
import { RecentFeatureFlagInsights } from './RecentFeatureFlagInsightsCard'
interface FeatureFlagOverviewProps {
featureFlag: FeatureFlagType
}
interface TagsDisplayProps {
tags: string[]
evaluationContexts: string[]
flagId: number | null
hasEvaluationContexts: boolean
}
function TagsDisplay({ tags, evaluationContexts, flagId, hasEvaluationContexts }: TagsDisplayProps): JSX.Element {
if (hasEvaluationContexts) {
return (
<FeatureFlagEvaluationContexts
tags={tags}
evaluationContexts={evaluationContexts}
flagId={flagId}
context="static"
/>
)
}
if (tags.length > 0) {
return <ObjectTags tags={tags} staticOnly />
}
return <span className="text-muted">No tags</span>
}
/**
* Readonly overview for feature flags, rendered as the Overview tab in FeatureFlag.tsx.
*/
export function FeatureFlagOverview({ featureFlag }: FeatureFlagOverviewProps): JSX.Element {
const { featureFlags } = useValues(enabledFeaturesLogic)
const { recordingFilterForFlag, featureFlagActiveUpdateLoading, deletedCohortFilters } = useValues(featureFlagLogic)
const { toggleFeatureFlagActive, editFeatureFlag } = useActions(featureFlagLogic)
const hasEvaluationContexts = !!featureFlags[FEATURE_FLAGS.FLAG_EVALUATION_TAGS] // NB: the tag was named "flag-evaluation-tags" before we renamed the concept – i.e. this powers evaluation contexts even though the name implies tags
const v1Filters = isV1FeatureFlagConfig(featureFlag.filters) ? featureFlag.filters : null
const multivariateEnabled = !!v1Filters?.multivariate
const variants = v1Filters?.multivariate?.variants || []
const hasPayload = !!v1Filters?.payloads?.['true']
const getFlagTypeDisplay = (): { icon: JSX.Element; label: string; description: string } => {
if (featureFlag.is_remote_configuration) {
return {
icon: <IconCode className="text-lg" />,
label: 'Remote config',
description: 'Single payload without feature flag logic',
}
}
if (multivariateEnabled) {
return {
icon: <IconList className="text-lg" />,
label: 'Multivariate',
description: 'Multiple variants with rollout percentages (A/B/n test)',
}
}
return {
icon: <IconFlag className="text-lg" />,
label: 'Boolean',
description: 'Release toggle (boolean) with optional static payload',
}
}
const flagTypeDisplay = getFlagTypeDisplay()
const getEvaluationRuntimeDisplay = (): { icon: JSX.Element; label: string; tag: string } => {
switch (featureFlag.evaluation_runtime) {
case FeatureFlagEvaluationRuntime.CLIENT:
return {
icon: <IconLaptop className="text-lg text-muted" />,
label: 'Client-side only',
tag: 'Single-user apps',
}
case FeatureFlagEvaluationRuntime.SERVER:
return {
icon: <IconServer className="text-lg text-muted" />,
label: 'Server-side only',
tag: 'Multi-user systems',
}
default:
return {
icon: <IconGlobe className="text-lg text-muted" />,
label: 'Both client and server',
tag: 'Single + multi-user',
}
}
}
const evaluationRuntimeDisplay = getEvaluationRuntimeDisplay()
const flagTypeCard = (
<div className="flex flex-col gap-2">
<label className="text-sm font-semibold">Flag type</label>
<div className="flex items-center gap-3 p-3 rounded border bg-surface-secondary">
{flagTypeDisplay.icon}
<div className="flex flex-col">
<span className="font-medium">{flagTypeDisplay.label}</span>
<span className="text-xs text-muted">{flagTypeDisplay.description}</span>
</div>
</div>
</div>
)
return (
<div className="flex flex-col gap-6">
<div className="flex gap-4 flex-wrap items-start">
<div className="flex-1 min-w-64 flex flex-col gap-4">
<div className="rounded border p-4 bg-bg-light flex flex-col gap-3">
{featureFlag.deleted ? (
<div className="flex items-center justify-between">
<span className="text-sm font-medium">Status</span>
<LemonTag type="danger" size="small">
Deleted
</LemonTag>
</div>
) : (
<AccessControlAction
resourceType={AccessControlResourceType.FeatureFlag}
minAccessLevel={AccessControlLevel.Editor}
userAccessLevel={featureFlag.user_access_level}
>
<LemonSwitch
checked={featureFlag.active}
onChange={toggleFeatureFlagActive}
loading={featureFlagActiveUpdateLoading}
disabledReason={
!featureFlag.can_edit
? "You only have view access to this feature flag. To make changes, contact the flag's creator."
: featureFlagConfigFormat(featureFlag.filters) === 'unsupported'
? UNSUPPORTED_CONFIG_DISABLED_REASON
: !featureFlag.active
? deletedCohortDisabledReason(deletedCohortFilters)
: null
}
label="Enable feature flag"
bordered
fullWidth
/>
</AccessControlAction>
)}
</div>
<EditableOverviewSection editOptions={{ expandAdvanced: true }}>
<div className="flex flex-col gap-4">
<div className="font-semibold">Advanced options</div>
<div className="flex flex-col gap-2">
{!hasEvaluationContexts && <label className="text-sm font-medium">Tags</label>}
<TagsDisplay
tags={featureFlag.tags || []}
evaluationContexts={featureFlag.evaluation_contexts || []}
flagId={featureFlag.id}
hasEvaluationContexts={hasEvaluationContexts}
/>
</div>
<div className="flex flex-col gap-2">
<label className="text-sm font-medium">Evaluation runtime</label>
<div className="flex items-center gap-2">
{evaluationRuntimeDisplay.icon}
<span className="text-sm">{evaluationRuntimeDisplay.label}</span>
<LemonTag type="muted" size="small">
{evaluationRuntimeDisplay.tag}
</LemonTag>
</div>
</div>
{!featureFlag.is_remote_configuration && (
<div className="flex flex-col gap-2">
<label className="text-sm font-medium">Persistence</label>
<span className="text-sm text-muted">
{featureFlag.ensure_experience_continuity
? 'Persists across authentication steps'
: 'Does not persist across authentication steps'}
</span>
</div>
)}
</div>
</EditableOverviewSection>
{!featureFlag.is_remote_configuration && (
<div className="rounded border p-4 bg-bg-light flex flex-col gap-3">
<div className="flex items-center justify-between">
<div className="font-semibold">Related insights</div>
<ViewRecordingsPlaylistButton
filters={recordingFilterForFlag}
type="secondary"
size="xsmall"
data-attr="feature-flag-view-recordings"
/>
</div>
<RecentFeatureFlagInsights />
</div>
)}
</div>
<div className="flex-[2] min-w-80 flex flex-col gap-4">
{!v1Filters ? (
<div className="rounded border p-4 bg-bg-light">
{isRulesV2FeatureFlagConfig(featureFlag.filters) ? (
<FeatureFlagRulesV2Readonly
config={featureFlag.filters}
active={featureFlag.active}
editButton={
featureFlag.deleted ? null : (
<AccessControlAction
resourceType={AccessControlResourceType.FeatureFlag}
minAccessLevel={AccessControlLevel.Editor}
userAccessLevel={featureFlag.user_access_level}
>
{({ disabledReason }) => (
<LemonButton
icon={<IconPencil />}
size="small"
type="secondary"
disabledReason={disabledReason}
onClick={() => editFeatureFlag(true)}
data-attr="edit-rules-v2-rules"
>
Edit rules
</LemonButton>
)}
</AccessControlAction>
)
}
/>
) : (
<FeatureFlagConfigReadonlyNotice filters={featureFlag.filters} />
)}
</div>
) : multivariateEnabled && variants.length > 0 ? (
<EditableOverviewSection
disabledReason={
featureFlag.experiment_set && featureFlag.experiment_set.length > 0
? 'Variants are managed by the linked experiment'
: undefined
}
>
<div className="flex flex-col gap-4">
{flagTypeCard}
<FeatureFlagVariantsSection featureFlag={featureFlag} variants={variants} />
</div>
</EditableOverviewSection>
) : (
<EditableOverviewSection>
<div className="flex flex-col gap-4">
{flagTypeCard}
<div className="flex flex-col gap-2">
<label className="text-sm font-semibold">Payload</label>
{hasPayload && v1Filters.payloads?.['true'] ? (
<JSONEditorInput readOnly value={v1Filters.payloads['true']} />
) : (
<div className="text-sm text-muted p-3 rounded border border-dashed bg-surface-secondary">
No payload configured
</div>
)}
</div>
</div>
</EditableOverviewSection>
)}
{v1Filters && !featureFlag.is_remote_configuration && (
<>
<EditableOverviewSection
disabledReason={
featureFlag.experiment_set && featureFlag.experiment_set.length > 0
? 'Release conditions are managed by the linked experiment'
: undefined
}
>
<FeatureFlagReleaseConditionsReadonly
id={String(featureFlag.id)}
filters={v1Filters}
isDisabled={!featureFlag.active}
evaluationRuntime={featureFlag.evaluation_runtime}
/>
</EditableOverviewSection>
</>
)}
</div>
</div>
<FeatureFlagImplementationPanel featureFlag={featureFlag} />
</div>
)
}