> ## Documentation Index
> Fetch the complete documentation index at: https://launchdarkly-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating and editing context kinds

> This topic explains how to create and edit context kinds.

> For the complete documentation index, see [llms.txt](/llms.txt). For the full documentation snapshot, see [llms-full.txt](/llms-full.txt).

## Overview

This topic explains how to create and edit context kinds.

## Create context kinds

<Note title="Creating context kinds requires specific permissions">
  You can only create new context kinds in the LaunchDarkly user interface (UI) if have a  role that allows the <code>createContextKind</code> action. The LaunchDarkly Project Admin, Maintainer, and Developer project roles, as well as the Admin and Owner base roles, all have this ability. To learn more, read [About member roles](/home/account/members#about-member-roles) and [Context kind actions](/home/account/roles/role-actions#context-kind-actions).
</Note>

You can create context kinds in the LaunchDarkly UI, or automatically when you evaluate a context using a LaunchDarkly SDK.

### Create context kinds in the UI

To create a context kind in the LaunchDarkly UI:

1. Navigate to the **Contexts** list.
2. Click the **gear** icon on the right. The context kinds list appears.
3. Click **Add kind**.
4. The "New context kind" dialog appears.
5. Enter a **Name** for the context kind. This appears in the context kind list, and as a filter option in the **Contexts** list.
6. Enter a **Key** for the context kind. You cannot change this later. It appears in the **Contexts** list and on the [context details page](/home/flags/context-details) in the "Attributes" section.
7. (Optional) Enter a **Description** for the context kind.
8. (Optional) Uncheck the **Available for experiments and guarded rollouts** checkbox if you don't want to use this context kind as a randomization unit in experiments and guarded rollouts. To learn more, read [Randomization units](/home/experimentation/randomization).
   * (Optional) Check the **Set as the default for experiments** checkbox if you want new experiments and guarded rollouts to default to this context kind as the randomization unit.
9. Click **Create kind**.

### Create context kinds from an SDK

To create a context kind automatically, create a context object in your LaunchDarkly SDK. When you evaluate a flag for the context, LaunchDarkly automatically creates a new context kind for that context's kind, if one of the same name does not already exist.

<Card
  icon={<img src="https://fern-image-hosting.s3.us-east-1.amazonaws.com/launchdarkly/terminal.svg" class="terminal" />

}
  iconPosition="left"
>
  Try it in your SDK: [Evaluating flags](/sdk/features/evaluating)
</Card>

<Card icon="link">
  You can also use the REST API: [Create or update context kind](/api-reference/contexts/create-or-update-context-kind)
</Card>

## Edit context kinds

You can edit existing context kinds from the context kinds list by clicking on the **three-dot** overflow menu next to the context kind and selecting "Edit."

You can edit the name and description of the context kind, but you cannot edit the key.

If you use [Experimentation](/home/experimentation) or [guarded rollouts](/home/releases/guarded-rollouts), you can also edit whether the context kind is available for these features, and whether the context kind should be the default for experiments and guarded rollouts. To learn more, read [Randomization units](/home/experimentation/randomization).