> For the complete documentation index, see [llms.txt](https://docs.usestencil.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.usestencil.com/integrations/airtable-integration/airtable-integration-basic.md).

# Basic

With Airtable integration, it allows images to be generated from data pulled from Airtable. Generated images are automatically populated back into Airtable.

### Requirements

* Airtable's Base ID
* Airtable's Table name
* Airtable's API Key

{% hint style="info" %}
You can get base ID for your airtable project by going to their documentation site
{% endhint %}

### 1. Set up your project with Airtable API Key

Go to project's setting page and paste your Airtable API Key.

![](https://1726200576-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYeUDPAhozAcUAcc2Lr%2F-MavSEJl6bTaMxXP_eIZ%2F-MavUYNWKc0XVJsXR3a4%2Fimage.png?alt=media\&token=12965956-4f6a-4e2a-a730-e492e1f0da98)

### 2. Create Airtable integration action

Go to your project and go to the Console page for the template that you would like to generate the image.

![Select Airtable Integration](https://1726200576-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYeUDPAhozAcUAcc2Lr%2F-MavSEJl6bTaMxXP_eIZ%2F-MavVHgsunCMiwRrcaj0%2Fimage.png?alt=media\&token=7060eca4-2251-445c-88e1-8200a7a901b9)

Then, create New Action.

### 3. Map the column in Airtable to your template 

Fill in the requested information in Step 1 and Step 2. You need Airtable's Base ID and Table name to complete this step.

Then, match the column name in your Airtable table to your template.

![](https://1726200576-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYeUDPAhozAcUAcc2Lr%2F-MavSEJl6bTaMxXP_eIZ%2F-MavWADYU7JMTkgBZF5y%2Fimage.png?alt=media\&token=1734c96d-5240-48b1-8430-efdd250c556f)

{% hint style="info" %}
For image modification, we support Airtable's field for URL, Text and Attachments.\
\
For multiple attachments, the first attachment will be used as the source of the image. We only support mime types `image/jpeg` and `image/png`.
{% endhint %}

![The difference between Attachment and URL/Text in Airtable](https://1726200576-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYeUDPAhozAcUAcc2Lr%2F-MfxN7tFNN0CR8HKUtZn%2F-MfxOKE_AgjWjM1nxfHo%2Fimage.png?alt=media\&token=8878d806-3735-4905-8e87-102d9d3a0325)

![Attachment Type](https://1726200576-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYeUDPAhozAcUAcc2Lr%2F-MfxN7tFNN0CR8HKUtZn%2F-MfxO_qWwTGqbzBe8gCz%2Fimage.png?alt=media\&token=800882a2-54a8-48be-a9a8-65fab71529ae)

![URL Type](https://1726200576-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYeUDPAhozAcUAcc2Lr%2F-MfxN7tFNN0CR8HKUtZn%2F-MfxOiCatMK99s_-NUjM%2Fimage.png?alt=media\&token=e60c2cb6-242f-4c13-a516-f685438f9e57)

### 4. Set the output column

Fill in the column name in Airtable that will be populated with your image. This column must be of type `Attachment`. 

Save your changes when you're done.

{% hint style="warning" %}
**The type of the column must be `Attachment`.**

Both PNG and JPEG images will be attached to the column.
{% endhint %}

### 5. Run your action

![](https://1726200576-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYeUDPAhozAcUAcc2Lr%2F-MavSEJl6bTaMxXP_eIZ%2F-MavWuaAmXWklWM_KHxW%2Fimage.png?alt=media\&token=85d02b04-a2e2-4061-9ad8-ebeada1f61e2)

Click on Run Action to start generating images. You can safely close the browser as the process is run in the background. 

Once they are done, you can view the generated images in Airtable. Both PNG and JPEG are uploaded to Airtable. 

{% hint style="warning" %}
Images are only generated for empty output column. If they already contain data, no images are generated for those particular rows.
{% endhint %}

### Example process

{% embed url="<https://www.usestencil.com/statics/videos/airtable-integration.mp4>" %}