Tagging Content in Agility

What is Content Tagging and why is it important?

Content Tagging is extremely useful for creating relationships between content items, or nesting lists within an item. Agility makes this process easy and seamless.  

Setting Up Content Tagging

Let’s go through the steps of setting up and getting started with content tags. 

Creating a Tag Model

The first thing we’ll need to do is create a model for Content Tagging. To do this from the Models Section in Agility 

1. Click New Content Model

2. Give it a Name, we'll use Tags

3. Add a simple Text Field and give it a name, we’ll use Title

4. Click Update Field

5. Click Usage on the right-hand side and then + Add

6. Give it a name, we used Tags again and then click Create List

You can now Navigate to the Content Dashboard, click your Tags List and then click New to start adding Tag options. 

Using your Tags Model

Your newly created Tags Model can now be added to another Content Model as a Linked List. To do this 

1. From the Content Model Dashboard, select the Content Model you’d like to add Tags to

2. From the Add Fields menu on the right-hand side, drag and drop Linked Content and add it to the Model

3. To keep it simple, we’ll name it Tags again

4. Under the Field Properties tab select the below options

• Link to: Content 

• Link Type: Specific Item(s) from a List 

• Render UI: Search List Box 

• Content Selection: Specific Content List 

• Content Reference: Your Tags List 

• Save Value to Field: Create a New Field 

• Visible Fields: Leave Blank 

You’ll now be able to go into the content you added the Tags field to and add Content Tags from the list you created earlier. 

Sample Content Tags API Response

Here’s how tags might look in an API response for a Blog Post 

Further Reading

• Content- First Approach
• Content Models
• Fields

Agility makes it easy for you to tag content, and reference other content lists within your item(s).

Select an Image

This practice is extremely useful for tagging content, creating relationships between content items, or nesting lists within an item. The image above shows a sample blog post thats tagged with Sports and Lifestyle tags.

With the various Render UI options Agility provides, you can allows your editors to search and select one, or many item(s) to tag and link your content to.

In this example, we will show you how to use the Linked Content field to tag content, more specifically, we will show you how to tag Blog Post articles with Tags.

Setting up Tagging

• Create your Content Models
• Initialize list of Tags
• Initialize a list of Blog Posts
• Create a Blog Post
• Tag your Blog Post

Creating your Content Models

First, we will create our Content Models for Blog Posts and Tags.

Tag Model

Create a Tag Model with a simple text field.

Select an Image

Once you've created your model, initialize a list of tags and create some content.

Select an Image

Blog Post Model

Next, you'll want to create a model for your Blog Posts. This model will contain the following fields:

• Title - Text Field
• Date - Date Field
• Tags - Linked Content Field
• Content - HTML Field

Select an Image

There are many ways to configure the Linked Content field type, and it is important to configure it in the way that works best for you.

Select an Image

Lets explore some of the Linked Content fields configuration options:

• Link To: Select whether this will be linked to existing Content or if it should create new content which is unique and only accessible to this item.
• Link Type: Select whether this will link to a whole list/item from Content or editors will select one or many items only from a list.
• Render UI: Select how you want to render this linked content field for editors.
• Content Selection: Force to a specific Content List or allow the user to select their own list.
• Content Reference: Select the content you want to reference.
• Show Embedded View of List: Renders a mini list-view of the linked content list, otherwise renders a link to the content list.

In this example, we went with the Search List Box UI. This will allow content editors to search for and select one or many items to link to or tag.

When you're done creating your Blog Post model, don't forget to initialize a new list of Blog Posts.

Create a Blog Post

Once your models are configured, you can proceed to create a new Blog Post to see the tagging functionality the Linked Content field provides.

Select an Image

You can see in the image above that when we start searching for a value; we are presented with possible results to select from our list.

When selected, you'll be able to see the tag(s) applied to your item. From there, you can open each tag to view or edit its content.

Select an Image

Sample API Response

Here's a sample of the API response with its tag(s):

{ "contentID": 16, "properties": { "state": 1, "modified": "2022-07-08T14:18:06.507", "versionID": 31, "referenceName": "blogposts", "definitionName": "BlogPost", "itemOrder": 1 }, "fields": { "title": "My First Post", "date": "2022-07-08T00:00:00-04:00", "tags": [ { "contentID": 11, "properties": { "state": 1, "modified": "2022-07-08T14:01:19.15", "versionID": 26, "referenceName": "tags", "definitionName": "Tags", "itemOrder": 2 }, "fields": { "title": "Sports" }, "seo": null }, { "contentID": 13, "properties": { "state": 1, "modified": "2022-07-08T14:01:28.367", "versionID": 28, "referenceName": "tags", "definitionName": "Tags", "itemOrder": 4 }, "fields": { "title": "Lifestyle" }, "seo": null } ], "content": "<p>This is my first blog post!</p>", "tags_TextField": "Sports,Lifestyle", "tags_ValueField": "11,13" } }

UI Options

Aside from the Search List Box UI we showed above, there are a few other Render UI Options available to choose from:

Checklist Box (Select Many)

Select an Image

Dropdown List (Select One)

Select an Image