- Getting started with Airtable
- Introduction to Airtable basics
- Contacting Airtable Support Updated
- Airtable home screen
- Glossary of Airtable terminology
- Airtable technical requirements
- Feature differences between Airtable on desktop and mobile
- Airtable keyboard shortcuts
- Using Markdown in Airtable
- Adding descriptions in Airtable
- Finding Airtable IDs
- Airtable Automations
- Automations Overview
- Automation feature walkthroughs
- Integrated automation walkthroughs
- Airtable automation walkthroughs
- Linking existing records using automations
- Conditional groups of automation actions
- Repeating groups of Airtable automation actions
- Creating recurring records using automations
- How to delay Airtable automation runs
- Prevent automations from triggering by mistake
- Use automations to timestamp status updates
- Automation Triggers
- Airtable Triggers
- Airtable automation trigger: When record matches conditions
- Airtable automation trigger: When a form is submitted
- Airtable automation trigger: When record created
- Airtable automation trigger: When record updated
- Airtable automation trigger: When record enters view
- Airtable automation trigger: At scheduled time
- Airtable automation trigger: When webhook received
- Airtable automation trigger: When a button is clicked
- Airtable automation trigger: When email received Updated
- Integrated Triggers
- Airtable Triggers
- Automation Actions
- Airtable Actions
- Airtable automation action: Send email Updated
- Airtable automation action: Create record
- Airtable automation action: Update record
- Airtable automation action: Find records
- Airtable automation action: Sort list
- Airtable automation action: Run a script Updated
- Airtable automation action: Generate with AI
- Integrated Actions
- Airtable automation actions: Slack
- Airtable automation actions: Google Workspace
- Airtable automation action: Send MS Teams message
- Airtable automation actions: Outlook
- Airtable automation actions: Jira Cloud
- Airtable automation actions: Jira Server / Data Center
- Airtable automation actions: Salesforce
- Airtable automation action: Create post in Facebook Pages
- Airtable automation actions: GitHub Issues
- Airtable automation action: Hootsuite post
- Airtable automation action: Send Twilio SMS
- Airtable Actions
- Airtable Bases
- Using Airtable Cobuilder
- Airtable bases overview
- Creating and managing Airtable bases
- Structuring bases in Airtable
- Moving bases between workspaces in Airtable
- Creating and managing tables in Airtable
- Creating Airtable base share links
- Importing third-party data into Airtable
- Using insights in Airtable
- Troubleshooting Airtable base performance
- Airtable Betas
- Collaborating in Airtable
- Airtable Enterprise Support
- General Enterprise information
- External badging in Airtable
- Using app library and components in Airtable Updated
- Ask an Expert beta overview
- European data residency at Airtable
- Airtable user groups overview
- Airtable Enterprise API
- Creating and managing data retention policies in Airtable
- eDiscovery APIs in Airtable
- Airtable and data loss prevention
- Accessing Enterprise audit logs in Airtable
- Set up Jira Server / Data Center to connect with Airtable
- Admin panel pages
- Airtable admin panel overview
- Users - Airtable enterprise admin panel
- Airtable admin panel user details
- Groups - Airtable admin panel
- Workspaces - Airtable Enterprise Admin Panel
- Bases - Airtable admin panel
- Interfaces - Airtable admin panel
- Data sets - Airtable admin panel
- Managed apps - Airtable admin panel
- Components - Airtable admin panel
- Reports - Airtable admin panel
- Settings - Airtable admin panel Updated
- Managing Enterprise organizations
- Managing Enterprise admins in admin panel
- Using Organizations
- Organization branding for apps in Airtable
- Enterprise Hub in Airtable
- Enterprise Hub: Org unit assignment with user groups Updated
- Deactivating, removing access, and reactivating users in the admin panel
- Managing user access to workspaces and bases
- Airtable Enterprise Key Management Updated
- Custom terms of use New
- Enterprise SSO
- General Enterprise information
- Airtable Extensions
- Airtable Fields
- Fields Overview
- Attachment
- Date-based fields
- Formula
- Getting Started with Formulas
- Formula Foundations
- The essentials of Airtable formulas
- Formula writing tips for beginners
- Troubleshooting formulas
- Basic calculations
- Conditional statements
- Logical arguments
- Working with dates
- Displaying DATETIME_FORMAT using the date field in Airtable
- Working with date functions in Airtable
- Calculating the difference between dates in Airtable
- Supported DATETIME_DIFF unit specifiers in Airtable
- Supported DATETIME_FORMAT format specifiers in Airtable
- Using the DATETIME_PARSE() formula in Airtable
- Working with timezones
- Record functions
- Text functions
- Numeric functions
- Common Solutions: Beginner
- Common Solutions: Intermediate
- Common Solutions: Advanced
- Long Text Field
- Linked Record Field
- Linking records in Airtable
- Limiting linked record selection to a view in Airtable
- Dynamic filtering in linked record fields
- Linking to one, many, or a subset of Airtable records
- Converting existing fields to Airtable linked records
- Reordering record links in Airtable
- Understanding linked record relationships in Airtable
- Number-Based Fields
- Other Fields
- Rollup, lookup, and count fields
- Select and user fields
- Integrating with Airtable
- API
- Getting started with Airtable's Web API
- Creating personal access tokens
- Airtable Webhooks API Overview
- Service accounts overview
- Airtable Web API - Using filterByFormula or sort parameters
- Airtable API Deprecation Guidelines
- Airtable API: Common troubleshooting
- Managing API call limits in Airtable
- URL length limitations for web API requests
- Integration services
- Third-party integrations via OAuth overview
- Troubleshooting disconnected OAuth integrations in Airtable
- Options for integrating with Airtable
- Third-party integrations - Common troubleshooting
- Low-code integrations - Common troubleshooting
- Integrating Airtable with external calendar applications
- Visualizing records from Airtable in Tableau
- Visualizing Airtable records in Microsoft Power BI & Power Query
- Integrating HubSpot with Airtable
- Using Zapier to integrate Airtable with other services
- Using Zapier's Multi-Step Zaps to find and update records
- Using IFTTT to integrate Airtable with other services
- Integrating with AWS Lambda & DynamoDB
- Developer tools
- API
- Airtable Interface Designer
- Interface Designer overview articles
- Interface layouts
- Interface elements
- Adding and removing elements in interfaces
- Adding layouts to interfaces
- Formatting elements in interfaces
- Interface element: Button
- Interface element: Calendar
- Interface element: Chart
- Interface element: Filter
- Interface element: Gallery
- Interface element: Grid
- Interface element: Kanban
- Interface element: Number
- Interface element: Record picker
- Interface element: Text
- Interface element: Timeline
- Learning and Resources
- Managing Airtable
- Airtable Policy
- Airtable Records
- Airtable Sync
- Airtable Views
- Airtable Workspaces
- Print
- Share
- DarkLight
- PDF
Adding descriptions in Airtable
- Updated on 28 Aug 2024
- 5 Minutes to read
- Print
- Share
- DarkLight
- PDF
All plan types | |
| |
Platform(s) | Web/Browser, Mac app, Windows app, and mobile apps |
Airtable terminology | Base guide - Unlike other surfaces in Airtable, a base description is referred to in the product as a Base guide. Typically, base guides will describe the broader details about the information contained within the base and therefore may require more information than other surfaces in Airtable. |
Why add descriptions in Airtable?
Descriptions in Airtable help your collaborators understand a particular part of the workflow. By providing descriptions in the surfaces covered below, owners and creators in Airtable can ensure that:
Onboarding new employees goes as smoothly as possible
Subtle or complex builds can be easily understood when changes need to be made in the future
When an employee leaves there is a "paper trail" of how and/or why something was built in Airtable
Other users understand why they may not want to change a certain configuration due to wider implications
Known points of confusion can be addressed in a way that prevents repetitive internal discussions or IT tickets
Adding and viewing descriptions in Airtable
Base guides
Unlike other surfaces, a description of a base is called a “Base guide” in Airtable because entire bases usually require a bit more information to fully explain. For that reason, after a base guide has been added, it will appear the first time another user opens the base.
To add a guide to a base or edit an existing guide, navigate to the base to which you'd like to add a guide. Next, click the dropdown arrow next to the base's name. Then, click the dropdown next to “Base guide” option.
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/base_guide_find_add_03302023.png)
This will open up a text box into which you can enter details about the base or edit an existing guide. You can also use Markdown within the base guide to add headers, links, emojis, and images.
Note
Creating a walkthrough video to help onboard future users is an excellent addition to a base guide. You can then add the video's link to the base guide.
Table descriptions
Sometimes the name of your table or view isn't long or detailed enough to explain everything. When this happens, you can add a description to make it easier for your collaborators to understand how the base is set up.
To add a description to a table, navigate to the table to which you'd like to add a description. Next, click the dropdown arrow next to the table name. From the dropdown menu, select Edit table description.
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/table_description_find_03302023.png)
This will open the description window where you can fill in a brief description of the table:
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/table_description_add_03302023.png)
The table description will appear when hovering over the table's name:
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/table_description_view_03302023.png)
View descriptions
View descriptions help to keep track of what each of your views is set up to display and communicate that information with other users. To add or edit a view description, start by clicking on the name of your view to expand the view options menu. Then click Edit view description.
This will open the dialog box where you can fill in a brief description of the view:
The view description will appear in two places:
By hovering over the view's name
By opening the views sidebar and finding the description under the view
Field descriptions
If the title of your field could use a longer explanation, you have the option of adding a more detailed field description to each of your fields. To add a field description, click on the dropdown arrow next to the name of the field to which you wish to add a description, then select Edit field description.
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/field_description_find_03302023.png)
This will open the dialog box where you can fill in a brief description of the field:
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/field_description_add_03302023.png)
The field description will appear when hovering over the field's name:
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/field_description_view_03302023.png)
Note
Field descriptions set up in a base will act as the default description/helper text for fields on interface record detail pages as well.
Automation descriptions
It's a best practice tip to add descriptions to every automation you create. Automations can have specific complexities that are more easily understood when a few details are provided in a description. To add an automation description, click on the dropdown arrow next to the name of the automation to which you wish to add a description, then select Edit description.
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/automation_description_find_03302023.png)
This will open the dialog box where you can fill in a brief description of the automation:
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/automation_description_add_03302023.png)
The automation description will appear in two places:
When hovering over the automation's name
In the automation list just below the automation's name
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/automation_description_view_03302023.png)
Extensions descriptions
Click Extensions from an open base containing the extension that you would like to describe. Then find the extension you want to describe and click the dropdown ⌄ next to the name of that extension.
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/extension_description_find_03302023.png)
This will open the dialog box where you can fill in a brief description of the extension:
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/extension_description_add_03302023.png)
The automation description will appear when hovering over the extension's name:
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/extension_description_view_03302023.png)
Workspace descriptions
Depending on how your organization is using Airtable, users might have access to multiple workspaces. In these cases, it could be helpful to add a workspace description, especially when onboarding new employees to your organization's Airtable ecosystem.
To add or edit a workspace description, first, navigate to a specific workspace from the Airtable home screen.
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/workspace_description_add_03302023.png)
This will open a text box where you can fill in a brief description. This is also where the description will appear in the future.
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/workspace_description_add_view_03302023.png)
Interface descriptions
There isn’t a dedicated way to describe an interface like a base guide. However, it’s a good idea to create an overview layout page when you need to give end-users a hub to access various resources in and outside of Airtable and orient them to their work in a meaningful way. Additionally, in certain interface layouts/pages, you can turn on field descriptions or enable helper text. This is helpful for both end-users and other creators who maintain apps at your organization.
Sync descriptions
Though syncs can be described at the table or view level, it may make sense to add more context in base guides as well.
Form descriptions
Giving more context for other creators can be helpful, however, the “Helper text” option for form fields is especially useful for potential form submitters. When configuring a form, creators can add a description below the title and add helper text below each field name.
![](http://cdn.airtable.document360.io/d0ee2ee4-3f78-47c7-b388-85e40be9fb89/Images/Documentation/form_description_helper_text_locations_2024.png)
FAQs
Why is it important to document the apps you build with Airtable?
As Airtable continues to lower the bar of software app creation, we are opening up the possibilities of relational databases, interfaces, automation, and AI to more people at all levels of expertise. The combination of flexibility and native features displays the true depth of Airtable. That depth, however, creates sophistication that may not always be intuitive to every user interacting with an app built within Airtable.
This means that the people who are building apps in Airtable should provide more detail about what they’ve built, how to interact with the app, or how certain parts of the app function on the backend.
There are two primary audiences to consider when documenting or describing in Airtable:
Other creators or admins across your organization or team
End users who have less or no access to the backend portion of the app you’ve built
Is there a character limit to descriptions?
Yes. Descriptions are limited to 20,000 characters.