Fields

Agility is equipped with many useful Field Types that can be used to help you successfully model your Content Models and Page Modules. 

Text fields in Agility CMS

Below is a list of field types, with descriptions and the properties they possess:

Text Field

A Text Field allows editors to enter a single line of editable text, often used for titles, labels or placeholders.

Maximum Length: Set an optional maximum character length for the field.

Default Value: Set an optional default value for the field.

Multi-Line Text Field

A Multi-Line Text Field allows editors to enter multiple lines of editable text.

Maximum Length: Set an optional maximum character length for the field.

Default Value: Set an optional default value for the field.

HTML Field

The HTML Field is a Rich Text Content Editor used to quickly and easily add and control the appearance of HTML content on a webpage without having to write HTML code.

Maximum Length: Set an optional maximum character length for the field.

Default Value: Set an optional default value for the field.

Dropdown List

The Dropdown List field allows editors to select one of many options in a dropdown list.

Dropdown List Choices: Define the list of choices that will be available to editors in the dropdown list. 

URL Field

The URL Field allows editors to define a URL thats links to an internal page, external page or to a file. 

Default URL: Set an optional default URL for the field. 

Open Link in New Window: Select whether you would like this link to open in a new window.

Number

The Number Field allows editors to enter a number.

Default Value: Set an optional default value for the field.

Decimal

The Decimal Field allows editors to enter a number in decimal format.

Default Value: Set an optional default value for the field.

Date/Time

The Date/Time Field allows editors to select a date and time. 

Include Time: Allow for time to be selected in addition to the date. 

Default to Current Date: Default the Date Selector to the current Date / Time. 

Default Value: Set an optional default value for the field. 

True/False

The True/False Field allows editors to select between a True or False value. 

Default Value: Set the default Boolean value to true of false. 

Linked Content

Linked Content fields allow you to reference another content list. This field can be useful for creating relationships between content items or nesting lists within an item.

The Linked Content field lets you link content from a new or an existing content list.

Example: Linking to a list of recently published blog posts.

Link To: Select whether this will be linked to existing Shared 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 Shared Content or editors will select one or many items only from a list. 

Render UI: Select how you want to render the user interface for the linked content field for editors. 

Shared Content Selection: Force to a specific Shared Content List or allow the user to select their own list. 

Shared Content List: The user may select the content they want to reference.

Custom Fields

Custom fields allow you to render a custom UI for a field that an editor interacts within Agility CMS.

Example: Color Picker Field

Custom Fields Type: Set the Custom Field Type for this field. 

Custom Section Fields

The Custom Section Field is a field that can contain custom HTML content and is only visible within the CMS.

Custom Section Content: Set the content for this Custom Section. 

Image

The Image Field allows editors to select an image. 

Require Alt Text: Require editors to set Alt text for screen readers. 

File Size: Set file size restrictions for editors to follow. 

Image Width: Set width parameters for this image. 

Image Height: Set height parameters for this image. 

Default Upload Folder: Set a default folder where files will be uploaded.

Gallery

The Gallery Field allows editors to select multiple images.

Gallery Type: Choose to create a new gallery, select a current gallery or leave it up to the editor to choose. 

Default Folder Name: Set a default folder name for this new gallery. 

File

The File field allows editors to select a file.

File Size: Set file size restrictions for editors to follow. 

Require Alt Text: Require editors to set Alt text for screen readers. 

Default Upload Folder: Set a default folder where files will be uploaded. 

List of Files

The List of Files field allows editors to select multiple files.

Default Upload Folder: Set a default folder where files will be uploaded. 

Field Limits and Validations

We provide advanced options for some of our fields such as Limits and Validations.

Limits

Often users are required to set limits to fields of text. Character limits can come from brand and style requirements to maintain brand compliance. Or to support rendering content on mobile devices with smaller screens.

By setting character limits the user is automatically blocked from entering characters when the text reaches the maximum character allowed. This removes human error and saves a lot of time and resources reviewing and fixing content.

Agility provides a quick and easy way to set character limits on Fields for both Content Models and Page Modules.

To set up Limits, navigate to your Models area, then select Page Modules or Content Models. For this example we'll be using a Page Module.

Page Module with text block in Agility CMS

Add or edit a Text field

Adding a text field in Agility CMS

Under Field Properties, you'll have an option to add a Maximum Length.

Adding maximum length to field properties in Agility CMS

Validations

Images and Files are an important piece of content but special care should be taken to ensure they are optimized for the web. Images that are not sized correctly will affect page performance and potential layout issues.

Agility provides a simple way to validate Image and File Fields for both Content Models and Page Modules. You can restrict by File Size, Height, Width, Valid File Types, and create custom Validation Message to help enforce proper image guidelines.

To set up Validations, navigate to your Models area, then select Page Modules or Content Models. For this example we'll be using a Page Module.

Setting up validations in Agility CMS

Add or Edit a File or Image Field.

Edit a file or image field in Agility CMS

For File Fields, you can add file size restrictions for Editors to follow.

Creating size restrictions for editors in Agility CMS

For Images, you will also be able to set the width and height parameters.

Creating image parameters in Agility CMS

Under Advanced Settings for Image and File fields, you can list the valid file types you would like your editors to use.

Advanced image and file settings in Agility CMS