Fields

Create a Field

Open or create the schema where you want to add a field e.g., a list, layer, virtual type, fieldset, and relation.

1. Open schema settings by double-clicking on the schema.

2. Select the fields tab in the right column of the schema detail view.

3. Add one or multiple fields, remove fields - make all changes.

4. Save when your work is done.

The status in the left column has a red mark to indicate that you have to re-index the search indexes after you made changes to fields.

Access the Field Path

The field path is the hierarchy of the field, which is the path where you can find the field. For the configuration of filters or display patterns, you need to access the value via field id or field path.  The field path always starts in lowercase. 

layerId.fieldId

You can open schemas > indexing. There you find the field path of every field of the schema. You can copy it by clicking on the value.

• Visual representation of the hierarchy of the field path syntax

  • productInformation.products

  • descriptiveKeyword.keywords

  • multimediaInformation.sources

You can open the Display Pattern Editor to see the JSON of a Content Item. 

Access the Field ID

The ID field is the ID of your field, which is used to link to this field. The field ID is always lowercase. The field's ID is set when creating a new field using camel casing. You need the field ID for the configuration of filters or display patterns. 

The ID is automatically created from the name you insert: 

• Example: You insert the field name "My NeW fielDs #1 Purpose?

• Automatic Id: myNeWFielDs1Purpose

You can open the Display Pattern Editor to see the JSON of a Content Item. 

Search for Specific Field Values

Update a Field / Edit a Field

Open the schema where you want to edit a field, e.g., a list, layer, virtual type, fieldset, and relation.

1. Open the settings with the gear icon.

2. Select fields in the sub-menu.

3. Find your field.

4. Select the edit icon next to it.

Some settings cannot be changed:

• Field Type

• The ID of the field

• Specific field properties:

  • Allow only single or multiple items for fieldset, relationships and tagbox

  • Adding translations for text fields

  • From date to date time and vice versa

  • From number to decimal and vice versa

When updating search settings, check the main menu for search indices badges and open the settings to reindex if required.

When updating the required flag, some items may miss the new required values. The Content Platform shows a message to inform you about this. However, there is no actual check if content items are affected. Admins must search for the field to find affected content items and batch edit them to add the required values. (see the search for a field). The required check does not work for fieldsets and relations. You must open the fieldset schema and check its usage in the overview panel – this does not work again for nested fieldsets (fieldset in fieldset in fieldset). Consider a batch edit or excel update to ensure data integrity.

Reuse a Field Name or Field ID

Open the schema where you want to re-create a field with a different ID or field type, e.g., a list, layer, virtual type, fieldset, and relation.

1. Open the settings with the gear icon.

2. Select fields in the sub-menu.

3. Find your field.

4. Remove the field.

5. Check the main menu for search indices badges and open the settings to reindex.

6. Re-open the schema and add your field again.

   1. Now you can use the same ID and change the field type.

   2. You can create the field as a new field.

When removing the field, all values are removed. Please export all values via Excel Export and use this Excel to populate the new field with the correct values.

Update the Field Order

This order is used for input, so the order your users see. Open the schema where you want to update the order of fields, e.g., a list, layer, virtual type, field set, and relation.

1. Double-click on the schemas.

2. Edit the fields in the right column of the schema details.

3. Drag & Drop the fields into the correct order

4. Save

You cannot reorder fields on a child that are propagated from a parent. Those fields are always at the top. The save button will be greyed out. 

Delete a Field

Open the schema where you want to edit a field e.g. a list, layer, virtual type, fieldset, and relation.

1. Open settings with the gear icon.

2. Find your field.

3. Edit fields (click edit or use shortcuts)

4. Select the x to remove the fields you want.

5. Save after you finish all changes.  

If you delete a field, you can only reuse the same ID when you update the status of Content and List Items from the Settings. Check the Main Menu for a badge that informs you about the necessity to perform an update. Removal of a field from a parent and adding the field to another parent works just fine without status updates.  

The field will not be removed from Filters or Display Pattern they are referenced in. You will need to do this manually. 

What could happen is: 

• Display of "Invalid template" in display patterns, if you worked with liquid tags

• Empty Filter in the Content Browser

You cannot remove a field that has XMP mappings.