The information in this article is relevant only for Pro users at this time. For information about booking websites for Lite users, refer to the Guesty Booking Engine

Airtable can be used as a collection for generating Dynamic Pages. For more information on collections, see Define a collection for Dynamic Pages.

Important:

Effective February 1st, 2024, API keys will be completely phased out. At this time, collections that have not had the API key switched to a personal access token may encounter disruptions.

 

Airtable collections have the following limitations:

 

Airtable

Collection number per site

100

Fields (columns)

100

Collection name character limit

50

Field name character limit

50

Page item URL

350 characters

Update data

Automatically every hour

To create an Airtable collection:

  1. In the left panel, click Content, click Collections, and then click + Add Collection.
  2. Click Airtable.
  3. Enter your Airtable Token.
    • Access token
  4. Enter your Airtable API credentials. 
    • API Key
      1. Click Airtable account page (located in step 1 of How to connect with Airtable).
      2. A new tab will open to your Airtable account page (you may need to sign in).
      3. Once signed in, visit airtable.com/create/tokens (if not signed in to Airtable, you will receive their 404 page).
      4. Once on the Personal access tokens page, click Create token.

      5. Enter in a name for the token.

      6. In the Scopes section, click + Add a scope and select data.records:read (See the data in records).

      7. In the Access section, click + Add a base and select the All current and future bases in all current and future workspaces option located under All Workspaces.
      8. Select the data.records:read (See the data in records) option.

      9. In the Access section, click Add a base.

      10. Select the All current and future bases in all current and future workspaces option located under All Workspaces.

      11. Click Create token.

      12. Click the copy button located next to the token.

      13. Return to Guesty Website and paste the token into the Access token field.

    • Example URL
      1. Click Airtable API page (located in step 2 of How to connect with Airtable).
      2. A new tab will open In Airtable (you may need to sign in).
      3. Once on the API Reference page, scroll down and select the desired table.
      4. In the side panel, click Authentication.
      5. In the curl tab, copy the link under EXAMPLE.
      6. Copy the link under EXAMPLE (located in the Curl tab).
      7. Return to Guesty Website and paste it in the Example URL field.
  5. Click Import Fields.
  6. Define the correct data type for each field.
  7. Click Continue.

Update an existing collection's API key with a personal access token

To update an existing collection’s API with a Personal Access Token:

  1. In the left panel, click Content, click Collections, and then the desired Airtable collection.

  2. Click Collection Settings located towards the bottom.

  3. In the Access Token field, replace the API Key with a personal access token.

    • To create a personal access token:

      1. Click Airtable account page (located in step 1 of How to connect with Airtable).
      2. A new tab will open to your Airtable account page (you may need to sign in).
      3. Once signed in, visit airtable.com/create/tokens (if not signed in to Airtable, you will receive their 404 page).
      4. Once on the Personal access tokens page, click Create token.

      5. Enter a name in the Name field .In the Scopes section, click + Add a scope and select data.records:read (See the data in records).

      6. In the Access section, click + Add a base and select the All current and future bases in all current and future workspaces option located under All Workspaces.

      7. Click Create token.
      8. Click the copy button located next to the token.
      9. Return to Guesty Website and paste the token into the Access token field.
  4. Click Refresh Data.

  5. Click Done.

Supported fields

Note

Airtable made changes to their URL attachments (such as links and images) causing them to expire after two hours. Guesty Websites is not affected by this change since it pulls data from Airtable on an hourly basis.

The following table outlines the supported Airtable fields, the corresponding Guesty Websites fields, and examples.

Guesty Websites Field Airtable Field Example

Text

Rich text

Welcome to my dentist office.

Note:

Using Airtable's built-in link rich text field is not supported. For example, to add a link, use the HTML: <a> </a>  tag.

Text

Long text

Note:

This field supports HTML and row breaks.

Text

Plain text

welcome to my office

Numeric

Number

10,000

Note:

Must only contain numbers, and periods (for decimals).

Boolean

Checkbox

Note:

Only for custom widgets.

Image

Attachment with one image

Image added through Airtable.

Link

URL

https://goo.gl/maps/F81HPm4CBTQSTsJ5A

Video

URL or text

https://www.youtube.com/watch?v=8EsYwAKxAFU

Phone

Phone number or text

123456789

Email

Email or text

email@email.com

Location

Text

streetAddress, postalCode, region, city, country

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

Business Hours

Text

SAT, SUN: 08:00-20:00; THU, FRI: 08:00-12:00;

Inner collection that contains one image field

Attachment with multiple images

Images added through Airtable.

Text

Number

 

Text

Currency

Note:

Displays only the number, without $ sign.

Text

Percent

Note:

Displays with decimal and without % sign.

Text

Rating

Note:

Displays the number.

Text

Formula

Note:

The result of the formula can be a string.

Text

Autonumber

 

Social account

Value

Must be formatted as name: value; name: value;

email: my@gmail.com; whatsapp: 123456; facebook: Guesty Websites;

Note:

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

Date & Time

Text

The default structure is YYYY-MM-DD HH:mm:SS, which displays as 2021-10-06 16:12:00. For a complete list of date and time formats and how they display, see Class DateTimeFormatter.

Note:

The site will always show in the UTC time zone, regardless of what is set in Airtable, even if the Use same time zone for all collaborators option is toggled on (in Airtable).

To avoid time zone confusion between the site and Airtable, it is recommended to enable the option Use same time zone for all collaborators (located in Airtable) and select the GTM/UTC time zone.

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

Multi Select

Multi Select

After defining the field as Multi Select, click Options to add options. Each row in the collection can be assigned one or more of the options you created.

Note:

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.

Note:

Due to API limitations, Guesty Websites will not import fields that do not have content in the first 10 rows.

Row order

When using Airtable collections, the row order is being pulled in randomly due to an API limitation on Airtable's site. We ignore filters or sorting in Airtable.

To pull the row order in the same order that exists in Airtable, including filters and sorting, add the Airtable View name to the example URL that you are using to import their collection. For more information, see Airtable support.

To add the view, after the example URL is added, add '?view=View Name'. The view name is case sensitive and should be typed exactly how it's written in Airtable.

Important:

Deleting or changing the view name after importing the collection will break the connection.

The following is an example of the URL before adding the view name:

https://api.airtable.com/v0/appbiL1pCyvFcW8WG/Feedback%20Session?view=Main%20View

The following is an example of the URL after adding the view name:

https://api.airtable.com/v0/appbiL1pCyvFcW8WG/Feedback%20Session?view=Main View

For more information on adding the view name to the URL, see this video.

The next step is to create or convert a Dynamic Page so you can connect it to your newly created collection. Or, you can connect the collection rows to regular pages. To learn how, see Connect Collection Rows to Regular Pages.

Was this article helpful?
0 out of 0 found this helpful