# Create a new attribute

{% hint style="info" %}
Attributes can be created manually, by [import](/system/ergonode-transfer.md), or via [API](https://docs.ergonode.com/v/graphql-api/).
{% endhint %}

To manually create an attribute click on *+ NEW ATTRIBUTE*.&#x20;

<figure><img src="/files/IO5XS3Huqua1LTh9A3mJ" alt=""><figcaption></figcaption></figure>

The first thing you need to do is to decide on the type of attribute you want to create.

{% hint style="info" %}
More information on attribute types can be found [here](/product-design/attributes.md).
{% endhint %}

{% hint style="info" %}
Once an attribute is created its type (or uniqueness if available) cannot be changed.
{% endhint %}

<figure><img src="/files/aAqRfMI1xIB5JOB88FGj" alt=""><figcaption></figcaption></figure>

When the type is chosen, you will see other configuration options, most options are the same across all types but some have extra ones.&#x20;

#### Options that are shared among all attribute types

| Option               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Attribute code       | Managing a large amount of data requires precision, therefore each attribute has its unique system code. This is the system name and thanks to its unique value, Ergonode recognizes the attribute and performs actions restricted to it. You can create a more intuitive name for an attribute in the [Translations ](/product-design/attributes/translations.md)tab, this cannot be changed after the attribute is created                                                                                                                                                                                                             |
| Scope                | Here are two options available. Global means that an attribute’s value will be the same for all languages. Local means that attribute value can be different for different languages. Remamber that this parameter cannot be changed after the attribute is created.                                                                                                                                                                                                                                                                                                                                                                     |
| Groups               | To effectively manage attributes used in similar contexts or by users with similar requirements, attributes can be grouped. For example, a user working exclusively with car audio products would only require attributes describing technical specifications only. It would therefore be helpful for them to create a group of technical attributes, such as power output, display type, aux-in, or dimensions. Groups can also be use to set [**Attribute privileges**](/system/user-roles/attribute-privileges.md)**,** which means you can set edit, read, or read-only privileges for users (available in higher license packages). |
| Create button        | When this button is clicked, the attribute will be created, but the user will not be moved to its edition page                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Create & Edit button | When clicked, this will create the attribute and move the user to the edition page for the new attribute                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

#### Attribute type-specific options

| Type         | Option                                                                        | Description                                                                                                                                                                  |
| ------------ | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Date         | Format                                                                        | This option let you choose a date format. Available options are: YYY-MM-DD, YY-MM-DD, DD.MM.YYYY, DD.MM.YY, DD/MM/YY, DD/MM/YYYY, Month DD, YYYY, DD Month YYYY, DD Mon YYYY |
| Numeric      | Require unique attribute value                                                | Available for **global** scope only. Allows for the uniqueness of attribute value system-wide. Configuration cannot be changed once the attribute has been created.          |
| Multi select | *Detials can be found in Options tab available after attribute being created* | *Detials can be found in Options tab available after attribute being created*                                                                                                |
| Price        | Currency                                                                      | This allows for choosing a currency. New currencies cannot be created, you may only choose from those that are available.                                                    |
| Select       | *Detials can be found in Options tab available after attribute being created* | <p><em>Detials can be found in Options tab available after attribute being created</em><br></p>                                                                              |
| Text         | Require unique attribute value                                                | Available for **global** scope only. Allows for the uniqueness of attribute value system-wide. Configuration cannot be changed once the attribute has been created.          |
| Text         | Max length                                                                    | 255 characters                                                                                                                                                               |
| Textarea     | Rich text content enabled                                                     | This will enable RTE editor, so you can use some HTML tags                                                                                                                   |
| Unit         | Unit                                                                          | This allows for choosing a unit. New unit can be created from [Settings](/system/settings/units.md)                                                                          |

{% hint style="info" %}
RTE Editor does not support all formatting options, ex; bold from web fonts with a font-weight parameter (Google Docs).
{% endhint %}

{% hint style="success" %}
TIP: The order in which values of the multi select attributes are selected/ticked on the product template defines the order of those attribute values in API.
{% endhint %}

<figure><img src="/files/jW5gGXwtMFiHCIo6YAkX" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://usermanual.ergonode.com/product-design/attributes/create-a-new-attribute.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
