Tags Field

The Tags Field represents a field that can be created in Model Builder, allowing the inclusion of relevant keywords related to the content in Entries.

This field is very useful for SEO strategy, enabling search engines to rank the site based on the content, and also makes searching easier for the users. For instance, using the tags field, editors can add relevant keywords that are related to the content of a blog article. The following section explains the configuration of the Tags field in the model builder and its usage in an entry, depending on these configurations.

Tags Field in Model Builder

When adding the Tags field in the model builder, you can configure its settings in the right sidebar. The field information that needs to be filled in includes:

  • Field name: This is the name of the field that will be displayed in entries and other relevant areas.

  • Alias: A required and unique identifier for the field, which cannot be modified once the field is saved.

  • Description: An optional field that allows you to describe the purpose or use case of the Tags field.

Once you have filled in the necessary field information in the configuration sidebar, you can click the "Create" button at the bottom, and the Tags field will be successfully added to the model editor.

Tags Field in Model Builder

Tags Field Configuration

By selecting the Tags field in the model editor, you have access to several quick actions. These actions enable you to delete the field, open the configuration sidebar, and adjust the field's position within the model.

The Configuration sidebar consists of three tabs: General, Appearance, and Validations. These tabs provide various settings and options for customizing the behavior and appearance of the Tags field.

General tab

The General tab in the configuration of the Tags field contains essential field information, including Field name, Alias, and Description.

Note that while Field name and Description can be modified even after saving the field, the Alias cannot be modified once the field has been saved in the model builder.

Appearance tab

The Appearance tab in the configuration of the Tags field focuses on how the field will be displayed in the entries created by the model. For this field, there is only one available option: "Tag" which is selected by default.

The Appearance tab also includes the Help Text field. This field can be used to display a tooltip in the entry, providing users with additional guidance and understanding of how to use the Tags field effectively.

Validations tab

In the Validations tab, you have the ability to apply constraints to the Tags field. These constraints enforce specific requirements on the field's input, ensuring that the entry cannot be published unless the Tags field adheres to these restrictions. The available options for validation include:

  • Required field: If you select this option, the Tags field must be filled when creating an entry. It becomes mandatory to input a value in the Tags field before the entry can be published.

  • Accept only a specified number of tags: This option allows you to limit the number of tags that users can add into the Tags field. Users will only be able to add tags within this specified range. The available options are:

    • Between: With this option, you can set both a minimum and a maximum value, limiting users to add tags that fall between these two values.

    • At least: This option sets a minimum value, and users must add tags that are equal to or exceed the specified minimum.

    • At most: This option sets a maximum value, and users must add tags that are equal to or below the specified maximum.

    • Exactly: With this option, you can set an exact number of tags, and users will be restricted to add entries within this defined range.

By leveraging the Validations tab, you can ensure that the Tags field in your model enforces specific constraints, maintaining data integrity and consistency in your entries.

Validations Tab

Tags Field in Entry Editor

The Tags field in the entry will be displayed and can be used based on the configuration in the model. Let's explore some appearances and use cases of the Tags field in the entry editor.

  • Help text: If a help text is added to the Tags field in the model's configuration, it will be displayed as a tooltip near the field's title in the entry editor, providing additional guidance.

  • Required field: If the Sections field is marked as a required field in the model, the user cannot publish the entry without adding a section to the respective field. A warning message with a red color will be displayed under the field, indicating that the Sections field is required.

  • Number of tags: If a specific number of tags is defined for the Tags field in the model, the user cannot publish the entry if the added tags do not fall within the specified range. A warning error with a red color will be displayed under the field, depending on the template configuration in the model.

Tags Field in Entry Editor