Thanks for purchasing our product!
You are about to connect your Airtable database to your WordPress website and manage your content better. Identify the Airtable tables you wish to link to WordPress, map the fields, choose post types, define your ideal update frequency, that’s it, your plugin will automatically import & sync everything swiftly!
To install our Air WP Sync plugin in WordPress, follow the steps below:
After installing and activating the plugin in WordPress, it will appear in the admin menu and access to the connection and configuration settings.
Before creating a connection, you are prompted to enter your license key to validate the installation of the plugin. To activate this license key, go to Air WP Sync > Settings.
The license key is available both in your purchase confirmation email, as well as on wpconnect.co > My Account > My Downloadable Products > License Keys, View Licenses.
You will then be redirected to the purchase page of your product. Click on the key icon to see the license number appears and copy-paste it into your Air WP Sync License Key field.
Once the license key is copied into the Air WP Sync settings, be sure to click the “Activate” button. If your license key is valid, a green checkmark will appear and you just need to save the settings by clicking the “Update settings” button.
You can then begin creating your connections.
To create a new connection to your Airtable account, go to Air WP Sync > All Connections, click the “Add New” button and enter a name for your connection.
⚠️ Air WP Sync now uses Personal access tokens
Personal access tokens in Airtable are in Now in beta. This a new, more secure way to grant API access to your Airtable data. Create multiple tokens, grant them access to specific bases, and manage them individually.
You will be asked for an Access token to connect your account. We recommend that you retrieve this token using the this link. Once you are on the overview page of your Airtable account, go to the API section and click the “Try it now” link. Once it has been generated, you can copy and paste it into the Access Token field.
Once your Personal access token has been entered in the field, choose the database from which you want to import content, as well as the table and/or views. You also have the option to add formula filters to your views, which work the same way as in Airtable.
You can import your content in several ways: Post, Page, or Custom Post Type.
Here’s how these three elements work:
In the case where you are using a theme and/or specific development, several other post types may be available to you. These are all Custom Post Types that have already been defined by your installed themes or plugins or by the developers of your WordPress site.
Our Air WP Sync plugin offers the ability to create your own Custom Post Types on-the-fly specifically for your imported content.
⚠️ Although WooCommerce Product CPT appears on the list, it’s only available for basic mapping configuration. WooCommerce Full integration will be available soon.
For the Custom Post Type that you will create from the Air WP Sync plugin, you will find the possibility of mapping the following WordPress fields: Title, Content, Slug, Custom Field.
It also allows you to create your own Custom Fields.
⚠️ CAUTION, if you decide to change the configuration and no longer use the Custom Post Type created specifically through the Air WP Sync plugin, this CPT created on-the-fly will no longer exist in WordPress and the content imported will also no longer be available.
Like in WordPress, imported content from Airtable can have different status: Published, Draft, Scheduled, Pending, Private.
Each of these status checks the following conditions:
Depending on the status chosen, the synchronized content will receive the status defined in the settings.
If you decide to change the status in the configuration later, note that the change in status of already imported content will depend on the import strategy you have defined (see the different content import strategies).
In the process of importing your content, you are required to choose an author that will be assigned to each imported content. The choice of this author must be made only among the registered users of the site, that is, users who have access to the administrative part of the site, regardless of their role.
It is currently not possible to import a user from Air WP Sync, but we are considering it!
You can now link your database fields with WordPress fields.
To do so, click the “Add field” button. Two drop-down lists are then available, one contains the fields of your Airtable database, the second the WordPress fields with which you can map them.
For articles, you will find the possibility to map the following WordPress fields: Title, Featured Image, Content, Excerpt, Slug, Tag, Category or Custom Field.
For pages, you will find the possibility to map the following WordPress fields: Title, Featured Image, Content, Slug, or Custom Field.
For existing Custom Post Types, i.e. created by plugins or WordPress themes present on your site, you will find the possibility of mapping the following WordPress fields and any Fields linked to your CPT: Title, Content, Slug, Taxonomies or Custom Field.
Taxonomies are used to group similar content across multiple CPTs. They can be used to create filters or searches for your content.
Example of fields available for a Property CPT: Title, Content, Slug, Property type (taxonomy), City (taxonomy), Custom Field, etc.
You can also consider adding specific fields to your content imported from WordPress by mapping your Airtable field to a Custom Field that you can name and which you will find in the imported content once the synchronization is complete.
⚠️ CAUTION, if you modify the configuration and remove a Custom Field that was created from the Air WP Sync plugin, you will not find it in any of the imported content.
You can choose the synchronization parameters of the Air WP Sync plugin.
By clicking on “Sync Now”, you can synchronize your content for the first time, even if you have not selected the “Manual Only” trigger
There are several import strategies for your Airtable content in WordPress. We have defined 3 of them which are: Adding / Adding and Updating / Adding, Updating and Deleting.
Each of these strategies works as mentioned:
Triggers allow you to control when data is imported from Airtable to WordPress. There are three possible trigger options: manual, recurrent and instant.
Once all the parameters have been configured, do not forget to publish your connection by clicking on “Publish” or “Update” in the case of a configuration modification. And, voilà !
If you have chosen a manual synchronization, do not hesitate to click on the “Sync now” button to synchronize your first contents and see them appear in WordPress.
If you use Elementor, Divi, Beaver Builder or any Page Builder to create and manage your site, you can use directly the content imported by Air WP Sync. You will find all the synchronized posts including the existing Custom Post Type and your Custom Post Type created with Air WP Sync.
Refer to your Page Builder documentation to enable, use your Custom Post Types and add them to posts loops or single templates.
In the same way, you can use the custom fields to display your data in pages, boxes, widgets or any dynamic elements such as button or tags which give you a high level of personalization!
Make sure you have created your databases and Airtable columns names before adding a new connection. If you don’t see it, wait 1 minute. For performance reasons, your Airtable elements are cached for one minute.
If needed, you can access to logs from a FTP server in this folder: /wp-content/uploads/airwpsync-logs
Some issues can appear when syncing. Some hosting providers disable a handful of PHP functions to help ensure performant servers. In case of syncing issues, check with your hosting provider if the getmypid function is not disabled.
If you have a large amount of content to import, the synchronization process will take some time for all the data to synchronize, especially if this is the first sync. You may have what is called a “Server Timeout”. It will depend of the number of rows you wish to import, the size and the number of images but also of the server settings. This is all the more likely to happen if you have opted for a basic hosting offer.
Check with your hosting provider and increase the execution time, allowed memory size and file size to the maximum if needed.
In case you have configured a Basic Authentication to protect the access to the site or to some information of the site, the call to WP Cron is then impossible, making the recurrent and instantaneous synchronization impossible.
WP-Cron needs page loading to trigger and therefore synchronize. In case you use a cache system (WP Rocket or WP Super Cache for example), it is therefore necessary to use a server cron.