Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  1. Fotoware Alto
    • 11.14 Schreckhorn
    • Terminology
    • Solutions
    • User Guide - Deutsch
    • User Guide - English
    • API Changelog
  2. Fotoware Veloz
    • Managing users and groups
    • Configuring archives
    • Configuring workflows
    • Configuring site behavior
    • Navigating and searching to find your assets
    • Working with your assets
    • Editing asset metadata
    • Uploading files
    • Version Control in Fotoware
    • Albums - Creating and sharing collections
    • Placing assets in a CMS
    • Working with the Fotoware Pro interface
    • Using the Fotoware plugins
    • Consent management
    • User guide to FotoWeb for iPad (Legacy)
    • Picture conferencing with FotoWeb Screens (Legacy)
    • What's what in Fotoware
    • GDPR
    • Fotoware Veloz releases
    • Activity Exports
    • Fotoware Example Workflows
  3. Fotostation
    • Getting started with Fotostation
    • Viewing, selecting and sorting files
    • Managing your assets with archives
    • Adding metadata to assets
    • Searching for assets
    • Working with your assets
    • Version Control in Fotostation
    • Automating tasks with Actions
    • Configuring metadata fields and editors
    • Configuring Fotostation
    • Configuring Fotostation for multi-user environments
    • Troubleshooting Fotostation
  4. Fotoware Flow
    • What is Flow?
    • Getting started
    • Flow dictionary
  5. Fotoware On-Premises
    • Getting started
    • Index Manager
    • FotoWeb
    • Color Factory
    • Connect
    • Operations Center Guide
  6. Integrations and APIs
    • The Fotoware API
    • Creating integrations using embeddable widgets
    • Authorizing applications using OAuth
    • Auto-tagging
    • FotoWeb Drag and Drop export
    • Integration using webhooks
    • Optimizely and Episerver plugin documentation
    • User Interface Integrations
  7. Fotoware Mobile
    • User guide for Fotoware Mobile for iPhone and Android
    • User guide to FotoWeb for iPad (Legacy)
    • User guide to FotoWeb for iPhone and Android (Legacy)

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Support

Table of Contents

Tagbox Overview Tagbox Value Handling Tagbox Field Settings
  • Home
  • Fotoware Alto
  • 11.14 Schreckhorn
  • Schemas
  • Fields

Tagbox

14. March 2025

Elaine Foley

Table of Contents

Tagbox Overview Tagbox Value Handling Tagbox Field Settings

The Tagbox field allows you to tag content, similar to tagging in social media, but with the option to 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 drop-down list of suggestions, or, you can 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.

Tagbox Overview

Icon
Behavior

There are two ways to enter data in this field:

  1. Click directly in the field to display a drop-down list of suggestions. You can also start typing in the field to filter the drop-down list of suggestions to match your input. Select a suggestion one by one (or select just one if it is a single tagbox field) to enter it in the tagbox field.
  2. Select this icon  in the tagbox field to open a dialog where can search, filter, sort, and create new list items. In this dialog, you can bulk select several list item suggestions in a multiple tagbox field. In a single tagbox field you can select only one. 
    In the following example, you can select a number of creators from the list, as well as filter the available options by Gender, Job function, and so on.

The List Display Pattern of the connected list is used for suggestions. Please ensure that the display pattern is adapted for correct suggestions. 

 
Main benefit

Tags are specific, they 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.

Connected List

You can create a tagbox without having the List created. When choosing your connected List you can create one. 

VIDEO: How To Create List From Tagbox Settings

Custom vs. System Lists

System Lists are already available in the system used in various places. You cannot change them or their values.

  • Country
  • Region
  • Language

Custom lists are lists you create for your purposes, like keywords, products, or events. 

List Items

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." 

View mode In view mode, the display of tags comes from the Name Display Pattern of the List, connected to the Tagbox field. 
Edit mode

In edit mode:

  • The assigned tags are displayed as defined in the Name Display Pattern of the List, connected to the Tagbox field. 
  • The suggested tags are displayed as defined in the List Display Pattern of the List, connected to the Tagbox field. 
Filters

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, for example, 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 narrow down the suggestions until you find the tag you are looking for. 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. 

  • Permissions: "Manage items" in the Schema Permission Set applied to the List
  • Create new tag while editing: 
    • Insert your required tag.
    • Get the message No matches found. Add a new [List Name] item.
    • Select the List where you want to add your new List Item. 
      This selection shows that the Tagbox connects to a parent List. You can select the correct child Lists your tags. The parent serves as a container for all children, which is used as a base for filters, allowing them to access multiple lists in one filter. 
    • See the fields configured on the List. 
    • Create and find your new tag directly assigned. 

VIDEO: How To Create New Tag While Editing 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: 

  • The card title, as defined in the List Display Pattern of the List, connected to the Tagbox field. 
  • The card body text, as defined in the Thumbnail Display Pattern of the List, connected to the Tagbox field. 
Examples
  • Product List
  • Employees
  • Campaigns
  • Events

Tagbox Value Handling

Picturepark Setup Example Layer: Corporate Information (ID: CorporateInformation) 
Field: Persons (ID: persons)
Fieldpath corporateInformation.persons
Usage in Excel LAYER.TAGBOX-FIELD.CONNECTED-LIST-FIELD
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:

  1. Assign Layer with Default Value for the Fieldset
    {
        "kind": "AssignLayerAction",
        "layerId": "Product",
        "defaultValues": {
            "fieldsetFieldId": {}
        },
        "traceRefId": null
    }
  2. Assign Tagbox Items
    {
        "kind": "AssignTagboxItemsAction",
        "path": "layerId.fieldsetFieldId",
        "fieldId": "tagboxId",
        "refIds": "$variable$",
        "replace": false,
        "traceRefId": null
    }

Advanced search for field

_exists_:corporateInformation.persons

  • This query finds all Content Items with the tagbox available and not empty. 
Advanced search for the field value Search: Find Items with Tagbox Values (Solutions)
Use in Display Pattern

Coding Advice: Push Tags in Display Pattern (Solutions)

Display Pattern: Tagbox (Solutions)

Unique Identifier

_refId

Search: Find Items by Ids (Solutions)

Returned field value

Single:

  • Field ID from the underlying schema
  • Value in field

Multi: Array

  • Field ID from the underlying schema
  • Value in field

Tagbox Field Settings

Name For single Tagboxes, use the singular for name, for example, department. 
Multi Tagboxes use plural names, for example, persons.
ID

The ID fieldis 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. 

 
Single item tagbox

Allow one or multiple tags. Once set and saved, this value cannot be changed later.

Use a single-item tag box when you want to ensure that only one tag is sufficient, such as for either-or questions, for example, state (active, passive).

Connected List

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. 

VIDEO: How To Create List From Tagbox Settings

Item filter Limit the List Items available for selection by using a filter, for example, show only actual products or employees from the board of management.
Minimum Only whole numbers (integers) are supported. Adding a minimum value sets the field required.
Maximum 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 Required ensures that editors add at least one tag. 
UI required The UI required field setting determines whether or not an editor must provide a field value to save the Content Item in the UI. If a field is UI required and the user has not provided a value or deleted the existing value, Content Platform does not permit saving the item in the UI. This value can be changed at any time.
The UI required field setting is unavailable for checkboxes, trigger fields, or dynamic view fields.
Sortable The Sortable field setting defines if Picturepark uses the values of those fields for sorting 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. 
Preview pattern 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. 
Default Values

Assign the default values for users creating 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, a link above the Filter field allows you to generate a Filter from Default values. 

VIDEO: How To Create 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.
Search Definition of the fields that Picturepark search considers. 
Boost Picturepark ignores the boost settings of the underlying schema.

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Fields
  • Common Field Settings
  • Checkbox
  • Date Time
  • Fieldset
eco-lighthouse-miljøfyrtårn

Company

  • About us
  • Resellers
  • Careers
  • Contact us

Help & support

  • Support center
  • Consultancy
  • Tech partners
  • Fotostation
  • System status

Trust Center

  • Legal
  • Security
  • Sustainability & ESG

Locations

Fotoware AS (HQ)
Tollbugata 35
0157 OSLO
Norway
FotoWare Switzerland AG
Industriestrasse 25
5033 Buchs (AG)
Switzerland

Copyright 2025 Fotoware All rights reserved.

  • Terms of service
  • Privacy policy
  • Cookie policy

Knowledge Base Software powered by Helpjuice

Expand