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

# Creating a Segment

> Define a new Segment in the Console to classify Accounts by shared characteristics or business rules.

A Segment classifies Accounts by shared characteristics or business rules.

## Before you start

***

You need an existing Organization and Ledger. Create Segments when Accounts need a shared classification for reporting, routing, fee rules, or operational controls.

## Create the Segment

***

To create a Segment, follow these steps:

<Steps>
  <Step>
    From the **Segments** page, click the **New Segment** button.
  </Step>

  <Step>
    The **New Segment** form will open on the right side of the screen.
  </Step>

  <Step>
    Specify the **Segment Name** in the **Segment Details** tab.
  </Step>

  <Step>
    (Optional) Select the **Metadata** tab to add any metadata that you want to use.
  </Step>

  <Step>
    Once the information is filled in, click the **Save** button.
  </Step>

  <Step>
    The Segment will appear in the list of available Segments for your Ledger.
  </Step>
</Steps>

## Field guide

***

| Field          | What to enter                                                               | Example            |
| -------------- | --------------------------------------------------------------------------- | ------------------ |
| Segment Name   | Required name for a group of Accounts with shared characteristics or rules. | `Retail Customers` |
| Metadata Key   | Optional classification or integration field name.                          | `region`           |
| Metadata Value | Value for the metadata key.                                                 | `BR-SP`            |

<Tip>
  The fields in the Metadata tab are open. There are no predefined keys or values. Use consistent key names across your Organization, such as `region`, `businessLine`, or `channel`, so Segments stay useful for filtering and reporting.
</Tip>

## What to do next

***

After creating the Segment, link it to Accounts from [Adding Segment to Account](/en/lerian-console/midaz-console/adding-segment-to-account), or create Accounts that should belong to it in [Creating an Account](/en/lerian-console/midaz-console/creating-an-account).

<Card title="API equivalent" type="tip" horizontal>
  [Create a Segment endpoint](/en/reference/midaz/create-a-segment)
</Card>