Feature Gating

Access to platform capabilities is controlled by your subscription tier. When you upgrade, new features unlock immediately.

How Feature Gating Works

1. The features GraphQL query returns a list of enabled feature keys for the currently authenticated user.
2. The frontend checks the user.features array to show or hide UI sections.
3. The sidebar dynamically renders navigation items based on which features are enabled.

Current State

Feature gating is available in the platform, but currently all core features are accessible on the Free tier. The following feature keys are returned by the features query and are always enabled:

Key	Description
AGENTS	Create and manage AI agents
TASKS	Task board (Kanban, list, calendar)
DATA	Knowledge base / vector spaces

The set of gated features may expand as new premium capabilities are introduced. The primary differentiation between subscription tiers is currently the agent slot limit (see Subscription Tiers), not feature access.

Frontend Behavior

• Navigation items tied to a gated feature are hidden entirely when the feature is not enabled -- users will not see greyed-out or locked menu entries.
• Attempting to access a gated route directly (e.g., via URL) will redirect to an upgrade prompt.

Unlocking Features

Upgrading your subscription immediately unlocks all features associated with the new tier. No sign-out or refresh is required; the sidebar updates on the next navigation.

tip

Use the whoAmI query to inspect your current subscription and the features query to list your enabled feature keys.