Import from Contentful

You can create a Grid by importing entries directly from your Contentful space, allowing you to work with your existing content in AirOps. If you haven't already connected your Contentful space to your AirOps workspace, you'll be prompted to do so.

How to Import Data from Contentful

1. Click the "+" button on your Grid page

2. Select Contentful from the dropdown menu of import options

3. Connect to your Contentful space:

   • Select an existing Contentful authentication from the dropdown, or set up a new one by entering your:

     • Space ID: Found in your Contentful dashboard under Settings > General settings

     • CDA Token: Content Delivery API token for accessing published content

     • CPA Token: Content Preview API token for accessing draft content

   • Click Continue

4. Select the content type to import:

   • Choose the Contentful content type (e.g., "Blog Post", "Page") from the dropdown

   • Click Continue

5. Select which data columns to import:

   • Check the boxes next to the fields you want to include

   • Each field will show its data type and a preview of sample data

   • Note: There's a maximum limit of 100 columns

6. Click Continue to import your data into the Grid

What Gets Imported

Once the import is complete, the following columns are automatically created in your Grid:

• Contentful Import: Shows the import status for each row

• Contentful Entry ID: Stores the unique Contentful entry identifier (sys.id) for each imported entry

• Created At: The entry's creation date in Contentful (sys.createdAt)

• Updated At: The entry's last update date in Contentful (sys.updatedAt)

• First Published At: The date the entry was first published in Contentful (sys.firstPublishedAt)

• Contentful Status: A single-select column indicating whether the entry is Published or Draft

• Your selected fields: Each field you chose during setup is mapped to the appropriate Grid column type

Field Type Mapping

Contentful field types are automatically mapped to the best matching Grid column types:

Contentful Field Type	Grid Column Type
Symbol (Short text)	Text
Text (Long text)	Text
Integer	Number
Number	Number
Date	Datetime
Boolean	Text
Rich Text	HTML
Location	JSON
Link	JSON
Array	JSON
Object	JSON

Draft and Published Entries

Contentful maintains separate draft and published states for entries. AirOps uses the Content Preview API to fetch all entries (including drafts) and reflects each entry's publication status in the Contentful Status column based on whether it has been published.

Localized Content

Contentful supports localized content fields. During import, AirOps extracts the value for your space's default locale. If your fields contain localized content, the default locale value will be imported.

Re-running Imports

You can re-run an import at any time to sync the latest data from Contentful. Existing rows are updated based on the Contentful Entry ID, and new entries are added as new rows. Entries that no longer exist in Contentful will have their cells cleared.

Once imported, your Contentful content will appear in your Grid, ready to be enhanced with AirOps workflows for content optimization, SEO improvement, AI-powered rewrites, and more.