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

# Attributes Interface

> Reference for the Rosetta Stone Attributes listing and Create Attribute pages

This reference documents the UI elements and actions available in the Rosetta Stone Attributes interface, where you can browse all attributes and create custom attributes for your organization.

## Listing page

**Path:** Rosetta Stone → Attributes

The listing page displays all Rosetta Stone attributes available to your organization, including global platform attributes and custom attributes created by your company or shared with you.

### Search and sort

* **Search** — Filter attributes by name, display name, or description using the search field
* **Sort** — Click column headers or use the **Sort** control to reorder the list

### Columns

| Column           | Description                                                                   | Sortable |
| ---------------- | ----------------------------------------------------------------------------- | -------- |
| **ID**           | Unique numeric identifier for the attribute                                   | Yes      |
| **Name**         | Machine-readable `snake_case` name (e.g., `iso_3166_1_country`)               | Yes      |
| **Display Name** | Human-readable label shown in UIs (e.g., "Country Code (ISO 3166-1 alpha-2)") | Yes      |
| **Description**  | Brief explanation of what the attribute represents                            | No       |

Each attribute row also displays a type icon indicating its data type.

### Row actions

Click the three-dot menu on any attribute row to access additional actions.

***

## Create Attribute panel

**Access:** Click the **Create Attribute +** button in the top right of the listing page

The Create Attribute panel opens as a side drawer where you can define a new custom attribute. Fields marked with a sparkle icon support AI-assisted generation — Rosetta Stone can suggest a display name, name, and description based on what you enter.

### Basic Information

| Field            | Description                                                                           | Required |
| ---------------- | ------------------------------------------------------------------------------------- | -------- |
| **Display Name** | Human-readable label shown in UIs. AI-assisted.                                       | Yes      |
| **Name**         | Machine-readable identifier. Must be `snake_case` (e.g., `user_email`). AI-assisted.  | Yes      |
| **Description**  | Explains what the attribute represents and how it should be interpreted. AI-assisted. | Yes      |
| **Tags**         | Freeform labels for organizing attributes. Type a tag and press Enter to add it.      | No       |

<Tip>
  Start by entering a display name — Rosetta Stone can generate the `snake_case` name and a description for you automatically.
</Tip>

### Type

| Field    | Description                                                                                                        | Required |
| -------- | ------------------------------------------------------------------------------------------------------------------ | -------- |
| **Type** | The data type for the attribute. Options: `String`, `Long`, `Double`, `Boolean`, `Timestamptz`, `Object`, `Array`. | Yes      |

See [Attribute Types](/reference/rosetta-stone/attribute-types) for details on each type and when to use them.

### Type Configuration

| Field              | Description                                                                                                   |
| ------------------ | ------------------------------------------------------------------------------------------------------------- |
| **Allowed Values** | Optionally restrict the attribute to a specific set of values (enum). Type a value and press Enter to add it. |
| **Join Key**       | Toggle on to mark this attribute as usable for joining datasets. Only applicable to primitive types.          |

### Collaborators

Control who can see and use your custom attribute. Both fields default to **Only my company**, keeping the attribute private to your organization.

| Field           | Description                                      | Default         |
| --------------- | ------------------------------------------------ | --------------- |
| **View Access** | Who can see this attribute in the attribute list | Only my company |
| **Map Access**  | Who can create mappings to this attribute        | Only my company |

To share your attribute more broadly, change these to include other companies or make the attribute visible to everyone on the platform.

### Creating the attribute

Click **Create** at the bottom of the panel to save the new attribute. The attribute is immediately available for mapping in the [Normalized Datasets](/reference/rosetta-stone/normalized-datasets-ui) interface.

***

## Related content

<CardGroup cols={2}>
  <Card title="Creating Normalized Attributes" icon="pen-ruler" href="/guides/rosetta-stone/creating-normalized-attributes">
    Best practices for designing attributes
  </Card>

  <Card title="Attribute Types Reference" icon="shapes" href="/reference/rosetta-stone/attribute-types">
    Complete type system documentation
  </Card>

  <Card title="Mapping Schemas" icon="diagram-project" href="/guides/rosetta-stone/mapping-schemas">
    Map dataset columns to your attributes
  </Card>

  <Card title="How Rosetta Stone Works" icon="gears" href="/concepts/rosetta-stone/how-it-works">
    Understand the normalization pipeline
  </Card>
</CardGroup>