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

# Create an Entity

> Learn how to create an entity in Confidence.

export const HowToSchema = ({name, description, steps = []}) => {
  const schema = {
    "@context": "https://schema.org",
    "@type": "HowTo",
    name,
    description
  };
  if (steps.length > 0) {
    schema.step = steps.map((s, i) => ({
      "@type": "HowToStep",
      position: i + 1,
      name: typeof s === "string" ? s : s.name,
      text: typeof s === "string" ? s : s.text || s.name
    }));
  }
  return <script type="application/ld+json" dangerouslySetInnerHTML={{
    __html: JSON.stringify(schema)
  }} />;
};

<HowToSchema
  name="Create an Entity"
  description="Learn how to create an entity in Confidence."
  steps={[
"Go to Confidence",
{
  name: "Select Admin > Entities",
  text: "On the left sidebar, select Admin > Entities.",
},
"Click + Create",
{
  name: "Enter the entity key",
  text: "In the Entity key field, enter a unique identifier for the entity. This key is used to reference the entity in the API.",
},
{
  name: "Enter the display name",
  text: "In the Display name field, enter a human-readable name for the entity.",
},
{
  name: "Specify the primary key type",
  text: "Select the data type of the identifier that identifies the entity. For example, if you have a UUID that identifies your entities, your primary key type is a String.",
},
"Click Create",
]}
/>

An [entity](../metrics/entities) is something that can be uniquely identified and randomized, like a user.

## Create an Entity

<Steps>
  <Step title="Go to Confidence" />

  <Step title="Select Admin > Entities">
    On the left sidebar, select **Admin > Entities**.
  </Step>

  <Step title="Click + Create" />

  <Step title="Enter the entity key">
    In the **Entity key** field, enter a unique identifier for the entity. This key is used to reference the entity in the API.
  </Step>

  <Step title="Enter the display name">
    In the **Display name** field, enter a human-readable name for the entity.
  </Step>

  <Step title="Specify the primary key type">
    Select the data type of the identifier that identifies the entity. For example, if you have a UUID that identifies your entities, your primary key type is a **String**.
  </Step>

  <Step title="Click Create" />
</Steps>

<Tip>
  To create entities via the API, see [Create Entities](../api/how-to-guides/metrics/create-entity) in the API how-to guides.
</Tip>

## Related Resources

<CardGroup cols={2}>
  <Card title="Entities Reference" href="/docs/metrics/entities">
    Deep dive into entity configuration
  </Card>

  <Card title="Create Assignment Tables" href="/docs/how-to-guides/create-assignment-table">
    Connect entities to experiments
  </Card>

  <Card title="Create Fact Tables" href="/docs/how-to-guides/create-fact-table">
    Set up measurements for your entities
  </Card>

  <Card title="Configure Metric Quickstart" href="/docs/quickstarts/configure-metric">
    End-to-end metric setup tutorial
  </Card>
</CardGroup>