Dynamic Content: Collections

Collections are an essential part of customized dynamic content solutions, such as dynamic pages. They function like databases that store lists of items with the same type of information (such as name, location, image, etc.). Collections serve as the data source, enabling the automatic display of updated content on dynamic pages or across your site when using collections on regular pages. While built-in features like blogs also use dynamic content, collections are critical for customized dynamic content solutions.

There are four types of collections (see Collection Types in this article). While collections are essential for dynamic pages, they can also be used on regular pages. For more information, see: Dynamic Pages and Collections for Regular Pages.

For example, a collection might contain information about properties available to rent:

collection-example.png

Collection Guidelines

Limitations and Specifications per Collection Type

Internal Collections

Google Sheets

Airtable

External

Collection Number per Site

100

100

100

100

A single collection's data

N/A

20MB

20MB

20MB

Rows

500

N/A

N/A

N/A

Fields (columns)

50

100

100

100

Collection name character limit

50

50

50

50

Field name character limit

50

50

50

50

Page item URL character limit

350

350

350

350

Text field character limit

5000

N/A

N/A

N/A

Inner collection Rows

Not supported

Not supported

Supported

N/A

Image Collection

Supported

N/A

N/A

N/A

Update data

Site/content library publish

Automatically

Automatically every hour

Automatically

Essential Formatting Guidelines

All collections should adhere to the following guidelines:

  • Field Names. The first row of the collection must contain the field names (for example, Number of Rooms).

  • Data Type. Data must be structured correctly based on the data type.

  • URL Field. Must be formatted as a string and only supports lowercase characters, numbers, dashes and underscores. Special characters are not supported.

  • Page Item URL Field (Airtable and Google Sheets). You must select a field from the Page item URL drop-down in the collection to define the URL of each page and what appears in the editor drop-down. If you already have a text field named page_item_url in your collection, it will automatically be mapped to this drop-down. If this field is not defined, page URLs are assigned numbers (Google Sheets) or a random string (Airtable).

  • Page Item URL. It is recommended the URL be in a URL format (for example this-is-an-example). The URL cannot contain special characters.

  • Business Hours. To use Business hours you must use the following specific structure in a text field (field type: business hours):SAT, SUN: 08:00-20:00; MON, FRI: 08:00-12:00;

  • Location. To use Location you must use the following specific structure in a text field (field type: location):

    String - streetAddress, postalCode, region, city, country

    846 Kerry Way, 90017, CA, Los Angeles, US

    The geo location is calculated from this string, the postal code is not mandatory but if the address is not written correctly (typos for example) we might not find it.

  • Nested Pages (Page Item URL; Airtable and Google Sheets). Collection names and URLs cannot contain nested pages for Airtable or Google Sheets. For example, you cannot use a page item URL with the structure example/subpage. This is supported for Internal Collections.

Available Fields

Below is a table with the data types that are available.

Note

For further details and data examples for specific collections types, please see their articles (Internal Collections, Dynamic Content: Google Sheets Collections, and Dynamic Content: Airtable Collections ).

Data Type

Uses and Notes

Plain Text

Standard text, can be used for widgets such as title tags and text widgets.

Rich Text

Rich text contains formatting, such as colors, styles, and links. Please note, rich text will come over differently per collection type, see documentation for each collection type (Internal Collections, Dynamic Content: Google Sheets Collections, Dynamic Content: Airtable Collections ). Not recommended for Airtable collections.

Image

This type is for a single image only.

Please note that the input methods are different per collection type, see documentation for each collection type (Internal Collections, Dynamic Content: Google Sheets Collections, Dynamic Content: Airtable Collections ).

Link

Pages will result in a 404 error if the URL contains a space at the beginning or end.

Number

Standard number. Can be whole numbers or decimals.

Date & Time

This field can be used for sorting when using the filters or sort functionality in the Connected Data pop-up.

Business Hours

Please note that the input methods are different per collection type, see documentation for each collection type (Internal Collections, Dynamic Content: Google Sheets Collections, anDynamic Content: Airtable Collections ).

Location

Please note that the input methods are different per collection type, see documentation for each collection type (Internal Collections, Dynamic Content: Google Sheets Collections, anDynamic Content: Airtable Collections ).

Video

Added with a link (Vimeo, YouTube, and Dailymotion videos are supported (videos uploaded to the editor, aren't able to be used in collections).

Email

-

Phone

-

Social Accounts

Supported social networks: email, whatsapp, facebook, twitter, instagram, youtube, linkedin, yelp, pinterest, google_my_business, waze, vimeo, snapchat, reddit, tripadvisor, foursquare, rss.

Please note that the input methods are different per collection type, see documentation for each collection type (Internal Collections, Dynamic Content: Google Sheets Collections, anDynamic Content: Airtable Collections ).

Multi-Select

This field can be used to filter the displayed collection in widgets, such as photo gallery, list, accordion, and custom widgets that connect to collections.

Please note that the input methods are different per collection type, see documentation for each collection type (Internal Collections, Dynamic Content: Google Sheets Collections, anDynamic Content: Airtable Collections ).

Inner Collection

Only available for Airtable collections (see Dynamic Content: Airtable Collections).

For Internal Collections, this is the data type Image Collection

Image Collection

Only available for Internal Collections (see Dynamic Content: Internal Collections).

For Airtable, this is the data type, Inner Collections.

Add a Collection to a Site

To add a collection to a site:

  1. In the left panel, click Content, click Collections, and then click + New Collection.

  2. Select the type of collection you want to create.

  3. When adding a Google Sheet or Airtable collection, define the correct data type for each field.