Overview

Creating an attribute means defining a reusable structure that can later power blocks and content with a controlled list of options. The process starts in the main form and continues into the values section, where each item is added individually.

Name
Type
Values

1

Where to start

Attributes → New

Attributes list in Studio CMS
In the Attributes area, the create button opens the form where the new structure will be configured.
Practical tip: before creating a new attribute, confirm whether another one already exists with a similar function. This avoids duplication and makes project maintenance easier.
2

Fill in the attribute basics

Main form fields

Attribute creation in Studio CMS
The creation form brings together the attribute's core fields and, just below, the section where values can be added one by one.

Required fields

  • Name identifies the attribute internally.
  • Machine name should be stable, technical, and without spaces.
  • Name (pt-PT) and Name (en-US) support the multilingual reading of the attribute.

Support fields

  • Order helps control the structure's position.
  • Active defines whether the attribute is operational.
  • The form notice indicates that fields marked with * are required.
Important: the machine name should be chosen carefully. It is a structural reference and should not be changed without reason once the attribute is already in use.
3

Choose type and content types

Two fields that define behavior

Attribute types in Studio CMS
The Type field defines the attribute's selection logic. In the example shown, Studio offers options such as Checkbox and Radio.
Content types available for an attribute in Studio CMS
The Content types field defines where this structure can be used, preventing the attribute from appearing in areas unrelated to its function.
  • Choose the type according to the experience the content will need.
  • Link the attribute only to the content types where it genuinely makes sense.
  • Avoid connecting the same attribute to too many areas if its function is highly specific.
4

Add values to the attribute

Internal list structure

1. Scroll down to the Values section

In the same form, the Values section is where each attribute item will be created individually.

2. Click the + button

The side + button opens a new space for adding a value to the structure.

3. Define the logic of each value

Each item should have a clear name, a consistent technical value, and, when relevant, supporting information for editorial or visual use.

4. Repeat for the remaining items

The process is repeated until the list is complete, organized, and ready to be used in the linked content.

Good practice: it is worth planning the whole list before you start adding items, so naming, order, and logic stay consistent across all values.
5

What to validate before saving

Quick consistency checklist

  • Confirm that the name and the machine name follow the same logic.
  • Validate that the chosen type really matches the intended behavior.
  • Check whether the linked content types are the right ones.
  • Confirm that the structure is set to active only when it is ready to be used.
  • Review the values list to ensure no essential items are missing.
Attention: saving an incomplete attribute may not trigger an immediate error, but it often creates inconsistency when the team tries to use it in real content.
6

Explore also

Related pages

Attributes

Go back to the concept page to review the role of this structure inside Studio CMS.

Edit an existing attribute and add new values

Move on to the maintenance flow when the structure already exists and needs to be updated.

Studio CMS glossary

Reinforce concepts such as machine name, value, content, and other product terms.

FAQs

Check quick answers to frequent questions about structure, content, and the backoffice.