Table of Contents
Fields
Table of Contents
Create a field
Open or create the schema where you want to add a field, such as a list, layer, virtual type, fieldset, or relation.
- Open schema settings by double-clicking on the schema.
- Select the Fields tab in the right column of the schema detail view.
- Add one or multiple fields, remove fields, and make the necessary changes.
- Save your changes.
The Dynamic View field allows relating content to other content based on metadata or other criteria, for example, relating content with the same document number, or relating content with the same product number, or the same event.
Get the field path
The field path is the hierarchy of the field, the path you use to find it. To configure filters or display patterns, you must access the value via field ID or field path. The field path always starts with lowercase letters.
layerId.fieldIdor,
You can open Schemas > Indexing. There, you find the field path of every field of the schema. To copy it, click 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.
Get 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 to configure 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 field values
Search: Find Items by Product Codes (Solutions)
Search: Check if Field Product Description Exists (Solutions)
Search: Find Product Information in Translated Description (Solutions)
Search: Find Items with Tagbox Values (Solutions)
Search: Find Items with Checkbox Values (Solutions)
Search: Find Items with Fieldset values (Solutions)
Search: Find Items with specific values in text fields (Solutions)
Search: Find Items with values in translated fields. (Solutions)
Search: Find Items with Exact Term in Translated Field (Solutions)
Search: Find Items with Value in a Field (Solutions)
Search: Find Items where Field or Layer is Empty (Solutions)
Update/Edit a field
Open the schema where you want to edit a field, such as a list, layer, virtual type, fieldset, or relation.
- Open the settings with the gear icon.
- Select fields in the sub-menu.
- Find your field.
- Select the edit icon next to it.
Video on how to update an existing field.
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
- Add 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 be missing the new required values. Fotoware Alto will display a message to inform you. However, there is no actual check to see if content items are affected. Admins must search for the field to find affected content items, then 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 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, or relation.
- Open the settings with the gear icon.
- Select fields in the sub-menu.
- Find your field.
- Remove the field.
- Check the main menu for the search indices badges, and open the settings to reindex.
- Re-open the schema and add your field again.
- Now, you can use the same ID and change the field type.
- You can create the field as a new field.
When the field is removed, all values are removed. Export all values via Excel Export, and use the Excel file to populate the new field with the correct values.
Update the field order
This order is used for input, so it's the order users see. Open the schema where you want to update the order of fields, for example, a list, layer, virtual type, fieldset, or relation.
- Double-click on the schemas.
- Edit the fields in the right column of the schema details.
- Drag and drop the fields into the correct order
- Save
Video on how to re-order fields in the edit mode (when editing fields).
You cannot reorder fields on a child that is 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, such as a list, layer, virtual type, fieldset, or relation.
- Open settings with the gear icon.
- Find your field.
- Edit fields (click edit or use shortcuts)
- Select X to remove the fields you want.
- Save.
Remove, Add, Update in Edit Mode
If you delete a field, you can reuse the same ID only when you update the status of Content and List Items in the Settings. Check the Main Menu for a badge indicating that an update is required. Removing 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 the Filters or Display Pattern in which they are referenced, indicating that an update is required. You 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.
Field types in Fotoware Alto
Each field has a set of attributes that determine its behavior. You configure the settings when adding the field to a Layer or Virtual Type, so different instances of the same field type can behave differently, depending on their specific settings. Some parameters are common to all the field types.
The Checkbox field is on or off (technically, true or false, a so-called Boolean). Its meaning depends on the label, e.g., Checkbox "PermissionDenied" ✔ means permission denied, whereas checkbox "PermissionApproved" ✔ means permission granted, although the checkbox in both cases has the same value (true), the understanding is different based on the label.
In the Text field, you can insert text, numbers, and special characters, which means unstructured information, as the user can write whatever they want - even High Valyrian, Valar morghulis, which almost nobody understands. Text fields, therefore, should have a clear label indicating their purpose, for example, Public social media description (avoid company bashing) or similar.
The Fieldset field shows a group of fields configured as a Fieldset schema. For example, for an address, you need three fields: Street (text), Zip (number), and City (text), which you can group into a single field (*fieldset) named Address. This grouping allows you to have a set of fields for adding address information, always available as one field (*fieldset).
The Relationship field allows you to relate content to other content, similar to hyperlinks (links) on the internet, and is especially useful for creating press kits, print packages, and landing pages by adding related visual content. For a press kit, you can link the hero image and the Logo.
The Date Time field allows input of a date or a date and time, and displays them in the format you specify, e.g., year/month/day or day/month/year.
The Geo Point Field has two number fields for adding longitude and latitude values. Applications like Google Maps use this kind of Geo-Information about a location. In Fotoware Alto, you can only use Geo Point values in Query Filters.
The Number field contains only numbers. If you are unsure if the expected values may contain text, then use a text field. Otherwise, use the Number field. The benefit is that you can calculate with numbers but not with text. For example, 2+2=4, but "Content" + "tent" is nothing.
The Tagbox field lets you tag content, such as social media, and configure the available tags. Tags work as a grouping of content. Tags are structured information because users cannot make typos when selecting from a predefined list. You can use Tags for regions, locations, moods, colors, product categories, countries, and almost everything. You can click directly in a tagbox field to display a dropdown list of suggestions, or select this icon to open a dialog where you can bulk-select several list items. You can also search, filter, sort, and create new list items in this dialog.
The Trigger field you can use to trigger a business rule, with the benefit that it stores the information about the user who clicked the field and when (date and time), whereas a checkbox "start business rule" would not have any information about the user or time.
XMP Mapping allows the extraction and import of XMP/EXIF data into Fotoware Alto metadata fields, and the export of data from Fotoware Alto metadata fields into XMP, based on field mappings. The XMP handling happens when importing files into Fotoware Alto or exporting from Fotoware Alto. XMP Mapping must be enabled via the API for the required output formats so that the downloaded output formats contain the data.
Display Patterns are configurable templates in Liquid Syntax (used in Shopify). In these Patterns, you take metadata and other values and construct a nice piece of information.
.png)
Code for Thumbnail Pattern List Item (Screenshot)
{% if data.fruit.shortDescription%}
{{data.fruit.shortDescription | translate | truncate: 250}}
{% endif %}
<br><be>
Product: {{data.fruit.code}} - {{data.fruit.name}}
<br>
Bricks class: {{data.fruit.bricks | tagbox_list | join: ", "}}
<br>
{% if data.fruit.price%}
Price: {{data.fruit.price}} {{data.fruit.currency.code}}
{% if data.fruit.unit%} per {{data.fruit.unit.name | translate}}{% endif %}
{% endif %}
{% if data.fruit.supplier %}<br>Supplier: {{data.fruit.supplier | tagbox_list}}{% endif %}The configuration supports different metadata values and static text combinations, including translations and tags. For configuration, you should be familiar with the field types in Fotoware Alto.
Display patterns are configured for Virtual Types, Layers, File Types, Lists, and Fieldsets. Some Display Patterns may not yet be in use. Fotoware Alto generates a display pattern for you when a text field is assigned. It will select the first available text field and display its value, if any.
The Dynamic View field allows relating content to other content based on metadata or other criteria, for example, relating content with the same document number, or relating content with the same product number, or the same event. This is especially useful for creating language versions of documents, product packages, or other content collections.
The Tree view allows users to model hierarchical data.
Tree view fields can be enabled for an instance in the License tab in the cloud manager. To do so, contact Fotoware Support.