The Tagbox field that allows you to tag content, basically like tagging in e.g., social media but with the difference that you can configure the available tags. Tags work as a grouping to content. Tags are structured information because a user cannot make typos but only select from a predefined list. You can use Tags for regions, locations, moods, colors, product categories, countries, and almost everything.
When you click into the field, you get suggestions. When you type, you get suggestions that match your input.
Tags are specific, support searching with a lot of additional attributes, and are easy to maintain. You can add attributes to the tags anytime, which extends the metadata for all tagged Content Items. You can translate only your tags and find your Content Items in all translated languages.
Tagboxes also support the user when adding metadata by showing suggestions, and the user cannot add wrong spelled product names or person names, so the metadata values are already "validated." By not allowing the creation of new List Items, users must work with approved terms only, and your metadata is safe.
Note: Permission to create new List Items: "Manage items" in the Schema Permission Set applied to the List.
Support for circular references allows for creating extended schemas.
You can create a tagbox without having the List created. When choosing your connected List you can create one.
Custom vs. System Lists
System Lists are already available in the system used in various places. You cannot change them or the values.
Custom lists are lists you create for your purposes, like keywords or products or events.
The List contains List Items, which have various attributes. The List Item can have a name only or a name, description, and further useful information.
When you connect the List to a Tagbox, the List Items become tags added to the Content Item, also known as "tagging."
In view mode, the display of tags comes from the Name Display Pattern of the List, connected to the Tagbox field.
In edit mode:
You can add a tagbox as a filter, using it as facet in the sidebar or for suggestions.
In the filter editor you select the tagbox._refid value as filter field, then you add a text field e.g. tagbox.name as search field. This way the tags are shown with a name. When a user selects a tag the ID is used to find the assigned Content Items, which is more accurate.
Suggestions in the Tagbox
When you click into the Tagbox Field, you get suggestions from the connected List. You can continue typing to drill down the suggestions further to find your desired tag. The suggestions consider the filter defined in the Tagbox Settings.
The Display Pattern List of the connected list is used for suggestions. Please ensure that the display pattern is adapted for correct suggestions.
With appropriate permissions, you can add new List Items while editing your Content Item.
Contextual information (card)
The assigned tags in view mode appear as clickable links. When you click the tag, you see a card with further attributes of the List Item.
The card display consists of:
Tagbox Value Handling
Picturepark Setup Example
Layer: Corporate Information (ID: CorporateInformation)
Usage in Excel
Tagbox in Fieldset in Business Rules
Entering a list item into a tagbox inside a fieldset requires to first initialize the fieldset, then add the value:
Advanced search for field
Advanced search for the field value
Use in Display Pattern
Returned field value
Tagbox Field Settings
For single Tagboxes, use the singular for name, e.g., department.
The field id is the ID of your field, which is used to link to this field. The field id is always lowercase. The id of the field is set on the creation of a new field, using camel casing. You need the field id for the configuration of filters or display pattern.
The ID is automatically created from the name you insert:
You can open the Display Pattern Editor to see the JSON of a Content Item.
Single item tagbox
Allow one or multiple tags. Once set and saved, this cannot be changed afterward.
Use single item tagbox where you want to make sure only one tag is sufficient like either-or questions, e.g., state (active, passive).
This List contains the List Items used as tags within the Tagbox field. You can create a tagbox without having the List created. When choosing your connected List you can create one.
Limit the List Items available for selection by using a filter, e.g., show only actual products or employees from the board of management.
Only whole numbers (integers) are supported. Adding a minimum value sets the field required.
Setting the maximum value to 1 turns a multi-item tagbox to a single item tagbox; however, we recommend choosing a single item tagbox instead.
Required ensures that editors add at least one tag.
The field setting "sortable" for a field defines if Picturepark uses the values of those fields for sorting of List Items (in Lists). Sorting of contents based on fields in a Layer is possible via the channel configuration, which only considers fields marked as sortable. All fields except for Geo Point and Relationship fields are sortable. This can be changed after field creation.
The option to define which Display Pattern shows in the view mode of the Tagbox. The Preview pattern allows showing the List Display Pattern with additional values instead of the Name Pattern, which shall be short and precise.
Assign the default values for when users create new tags while editing Content Items. When you add default values, you can also create the filter for the Tagbox from them.
When Picturepark finds Default Values, you find a link above the "Filter" field that allows generating the Filter from Default values.
Include in Filters
Sorting of tagboxes and fieldsets uses the "Name" display pattern of the items. There is a language fallback.
Definition of the fields which Picturepark search considers.
Picturepark ignores the boost settings of the underlying schema.