> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lightdash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Feature badges reference

> Definitions for maturity, plan, and deployment badges in the Lightdash docs

Feature badges link here for maturity, plan, and deployment definitions.

## Maturity

### Experimental

Experimental features are where we explore new ideas and test out proof of concepts.

* We're still building out core functionality, so things may be incomplete or unstable
* We might make breaking changes without much notice as we iterate
* Access can be limited to our internal team and design partners; the feature's page identifies who can use it
* Our design partners help us figure out what the feature should do and how it should work
* We're in full feedback-driven development mode

### Beta

Beta features are usable, but they might change. We may redesign or rethink them based on what we learn.

* You can use these features, but don't build workflows around them that you can't undo
* Expect breaking changes — the API, behavior, or UX may change as we iterate
* We're actively gathering feedback to shape the final design
* Documentation is available, but may evolve alongside the feature
* Our support team can help, though some rough edges are expected

### Generally available (GA)

GA features are stable. GA is a promise about stability — you can depend on these features in production.

* The API won't break and the UX won't fundamentally change
* We're committed to backward compatibility
* Complete documentation and training materials are available
* Fully supported by our team

### Feature lifecycle

```mermaid theme={null}
flowchart LR
    A(Experimental) --> B("Beta")
    B --> C("Generally Available (GA)")

    style A fill:#83E2B7,stroke:#83E2B7,color:#0B0B0D
    style B fill:#D9B3FF,stroke:#D9B3FF,color:#0B0B0D
    style C fill:#5E4CFF,stroke:#D9B3FF,color:#fff

    linkStyle 0,1 stroke:#9990C4,stroke-width:1px
```

Features progress from Experimental through Beta to generally available

## Deprecated

A deprecated feature is still available, but you should use its documented replacement where one exists. Deprecation follows availability; it is not a maturity stage between Experimental, Beta, and GA. The feature's page describes the replacement and any migration steps.

## Plan access

Enterprise includes everything in Cloud Pro.

### Pro

These features require a Lightdash Cloud plan, either [Cloud Pro](https://www.lightdash.com/pricing#:~:text=Compare%20our%20plans) or [Enterprise](https://www.lightdash.com/pricing#:~:text=Compare%20our%20plans).

### Enterprise

Enterprise adds features such as [custom roles](https://docs.lightdash.com/workspace-admin/custom-roles.md), [SCIM provisioning](https://docs.lightdash.com/workspace-admin/sso/scim.md), and [pre-aggregates](https://docs.lightdash.com/semantic-layer/pre-aggregates). You can use Enterprise on Lightdash Cloud or [self-host it with a license key](https://docs.lightdash.com/self-host/enterprise-features).

### Add-ons

[Embedding](https://docs.lightdash.com/embed) and [data apps](https://docs.lightdash.com/data-apps) are available as add-ons to Cloud Pro and Enterprise.

## Deployment

### Cloud-only

The feature works only with Lightdash Cloud. This is about where Lightdash runs, rather than your plan. For example, [Lightdash Desktop](https://docs.lightdash.com/agents/lightdash-desktop.md) connects to Lightdash Cloud organizations.

### Self-hosted

These instructions apply when you run Lightdash on your own infrastructure.

## Setup and permissions

Some features need setup even when your plan includes them. A callout on the feature's page explains any extra steps, such as configuring a provider, requesting a feature flag, or setting an environment variable on a self-hosted instance.

Your role and data permissions still apply. The feature's instructions tell you if you need an admin or another specific role.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.