Collections

Modified on Thu, 17 Nov, 2022 at 4:47 AM

The first step in creating Dynamic Pages is to define a collection. Collections contain lists of items that have the same type of information (name, location, image, and so on). Every site can have up to 100 collections.

Note

Collections for Legacy Pro and Team plans are limited to 1 internal collection per site with 10 rows.
Internal Collections for Agency and Enterprise plans are limited to 200 rows and 50 fields.
Inner collections (collections inside a collection) are limited to 30 rows and 10 fields.
Collection names and field names are limited to 50 characters.
Text fields in internal collections are limited to 2000 characters.
External collections (Google Sheets, Airtable and external database) are limited to 100 fields.
Changes to external collections update automatically every hour.

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

Property Name	Square Feet	# of Rooms	Price	Location	Image
Property A	2000	3	500,000	Tempe, Arizona	URL
Property B	1000	1	200,000	Denver, Colorado	URL
Property C	1500	2	300,000	London, UK	URL

Collection Types

You can create many types of collections:

Create Collections

For specific instructions on creating collections, see the article specific to the collection type: Internal Collections, Google Sheets, Airtable.

All collections should adhere to the following:

The first row of the collection must contain the field names (for example, Number of Rooms).
Data must be structured correctly based on the data type.
For 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 namedpage_item_urlin 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).
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;
To use Location you must use the following specific structure in a text field (field type: location):
String - streetAddress, postalCode, region, city, country
577 College Ave, 94306, CA, Palo Alto, 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.

To create a collection:

In the left panel, click Content, click Collections, and then click + New Collection.
Select the type of collection you want to create.
Connect to the collection.
Define the correct data type for each field.
Click Done.

The new collection displays in the collection panel. The next step is to create or convert a Dynamic Page so you can connect it to your newly created collection.

Lock Collection for Client Editing

You can lock a collection to prevent clients from editing it. This can be done in the editor or by using our collections API.

To lock a collection in the editor, in the side panel, click Content and then click Collections. Click the settings () icon next to the collection you need to lock. Select Lock, Complete Lock, or Structure Lock depending on which type of collection you are locking.

The following are the lock options:

Lock. Use to prevent the client from editing or deleting fields in external collections or changing content in image collections.
Complete Lock. Use for internal collections to prevent the client from editing or deleting collection data in rows and fields.
Structure Lock. Use for internal collections to prevent the client from renaming, deleting, or adding fields. Clients are still able to edit content and add rows. Using the structure lock is helpful when you do not want your client to accidentally modify the fields that power your dynamic pages.