Data types

Defining, editing, and deleting attribute data types and the schemas that form the Detail form on the value screen.

The Data types screen is where you define the value types of attributes. Each data type serves two purposes: it indicates what kind of value the attribute holds (e.g., text or number) and optionally carries a Schema. If a schema is defined, an additional form named Detail appears in the value window of attributes using this data type, and you define the form fields on this screen. The screen is intended for catalog managers who set up the attribute infrastructure.

Accessing the screen

Follow the path PIM & Catalog › Setup › Data types from the left menu. The screen title appears as Attribute data types.

If you do not see it in the menu, your account lacks permission for this screen. If you can open the screen but do not see the New data type button or the edit/delete icons in the rows, your account has view-only permission.

Screen sections

Header area: Screen name, brief description, a green badge showing the total number of data types (e.g., "8 data types"), and the New data type button if you have write permission.
List: All data types are shown in a single table, sorted by Id ascending. There is no search, filter, or pagination.

List

Column	Meaning
Id	The system number of the data type.
Type	The name of the data type. When defining attributes, one of these types is selected in the Data type field.
Schema	If a schema is defined, a blue badge shows the number of fields (e.g., "3 fields"), with the keys of the fields listed next to it. If the list is long, it is truncated to two lines; hovering shows the full list. If no schema exists, "—" is shown. If the schema is stored but cannot be parsed, a yellow Schema unreadable badge appears.
(action icons)	Edit (pencil) and Delete (trash). Visible only to users with write permission.

Clicking on the row itself does not open anything.

Actions

Creating a new data type

Click the New data type button at the top right. The New data type window opens.
Enter the name of the data type in the Type field. This field is required; leaving it empty shows a "Required field" warning. Leading and trailing spaces are trimmed on save.
If needed, define fields in the Schema section (see Editing the schema below). If no schema is defined, no "Detail" form appears for this type; the window shows the note "No schema defined; no "Detail" form will appear for this type."
Click the Save button.

Result: A "Data type saved." notification appears, the window closes, and the list refreshes. If saving is rejected, a red warning bar appears at the top of the window with the reason, and a "Something went wrong" notification appears; the window remains open.

Editing a data type

Click the pencil icon (Edit) in the relevant row. The Edit data type window opens with the current name and schema.
Change the Type name or the schema.
Click the Save button.

For types with unreadable schemas (those with the Schema unreadable badge), the pencil icon is disabled. Hovering shows the explanation "The schema of this type is not in the expected format; editing would delete the stored definition." This restriction prevents accidental deletion of the stored definition.

Editing the schema

The schema is displayed as a tree. Each row shows the field's title, the key in gray text, the type (gray badge), a yellow Required badge if mandatory, and a blue badge showing the number of options for list-type fields.

To add a field:

Click the Add field button below the schema. The Schema field window opens.
Fill in the fields below.
Click the Save button in the window. The field is added to the tree.

Field	Required	Description / rule
Title	Yes	The name shown to the user in the Detail form. When entering the title in a new field, the Key is auto-filled (spaces removed, subsequent words capitalized; e.g., "Fabric Type" → `kumaşTipi`). The key is regenerated each time you change the title in a new field; if you want to edit the key manually, do so after entering the title. Editing a saved field does not change the key.
Key	Yes	The name under which the value is stored. Cannot be the same as another field at the same level; if duplicated, a "This key already exists at this level." warning appears. Leading and trailing spaces in Title and Key are trimmed on save.
Type	Yes	The field type; selected from a list. Defaults to `text` in new fields. See the table below.
Description	No	Notes about the field.
Required	No	If checked, an asterisk `*` appears next to the field's title in the Detail form.

Do not change the key later. As noted in the field tooltip, the value is stored in the JSON object under this name; changing the key orphanizes previously entered values.

Field types and their counterparts in the Detail form:

The Detail form appears under the Detail heading in the value window of an attribute using this data type, with a separate tab for each language.

Type	In Detail form
`text`, `url`	Single-line text box.
`number`	Number-only input box.
`select`	Dropdown list; options defined in the List options section.
`multipleselect`	Multi-select list; options defined in the List options section.
`radiolist`	Options defined in the List options section; appears as a text box in the Detail form.
`boolean`	Checkbox.
`textarea`, `html`	Multi-line text box.
`date`, `datetime`	Date and time picker.
`file`	File address box.
`object`	Group that collects child fields inside a frame.
`array`	Repeated rows; each row contains values of the same structure.

List options (select, multipleselect, radiolist): When one of these types is selected, the List options section opens in the window.

Enter the value to be stored in the Key box.
Enter the text to be displayed in the Tag box. If left empty, the key is used as the tag.
Click the Add button. The button is disabled if Key is empty. Duplicate keys are not added.

To remove an option, click the trash icon in its row.

Adding child fields (object and array): These field types have an Add child field (plus) icon in their row. object can have unlimited child fields. array carries only a single element schema; after adding the first child field, the icon is disabled and the explanation "Array carries a single element schema; edit the existing field." appears.

Editing or deleting a field: Reopen the Schema field window with the pencil icon in the row, or remove the field (with its child fields) using the trash icon. Deletion does not ask for confirmation. Fields removed from the schema no longer appear in the Detail form; previously entered values remain stored as they were.

All changes to the schema (adding, editing, deleting fields) become permanent only when you click the Save button in the data type window. The Save button in the Schema field window only adds to the draft. If you close the data type window with Cancel, all schema changes are lost.

Deleting a data type

Click the trash icon (Delete) in the relevant row.
In the Delete data type window, verify the name of the type to be deleted. The window also reminds you that deletion will be rejected if the type is in use.
Confirm with the red Delete button or exit with Cancel.

Result: A "Data type deleted." notification appears and the list refreshes. If the data type is in use, deletion is rejected; the reason appears below the "Something went wrong" notification. There is no way to undo deletion on the screen.

Common situations

Pencil icon disabled. The schema of this type is in the Schema unreadable state. Hovering over the badge shows the raw stored schema text. This type cannot be edited from the screen; contact your system administrator to fix it.
Cannot delete data type. The type may be used by one or more attributes. Read the reason in the notification; first change the data type of the relevant attributes.
No form under "Detail" in the attribute value window. The attribute's data type has no schema defined. If a configuration is stored, it is shown read-only with the note "This data type has no schema defined; the stored configuration is shown as is." Add at least one field to the data type here and save.
Schema field does not save. Title and Key must be filled, and the key must not conflict with another field at the same level.
Schema changes lost. You may have closed the data type window without clicking the Save button after adding fields.
List says "No records found" or shows an error. No data types are defined or the list failed to load. In case of error, click the Retry button.