Important: If you modify your fields in your Airtable base, you must refresh the node’s field data in Gumloop to see these changes.
To refresh field options:
Click the refresh icon (🔄) next to the Table dropdown
This will update the available fields to match your current Airtable table structure
You’ll need to reconnect any outputs that were using fields that have been renamed
When to refresh your field options:
After adding new fields to your Airtable table
After renaming existing fields in your table
After deleting fields that are no longer needed
When new fields in your table don’t appear as outputs in the node
Failure to refresh field options after modifying your Airtable table structure is a common cause of workflow failures. Always refresh when you make changes to your table fields.
Think of Search Column and Search Value like a filter for your data:
First, pick which column you want to filter by (Search Column)
Then, specify what you’re looking for in that column (Search Value)
Simple Example:
Copy
Ask AI
If your table has a "Status" column and you want to find all "Active" projects:- Search Column: Status- Search Value: Active→ This will only return records where Status = "Active"
Important Notes:
Must match exactly (including letter case)
“Active” will not match “active” or “ACTIVE”
“In Progress” will not match “In progress”
No partial matches (“Alex” won’t find “Alexander”)
More Examples:
Finding High Priority Tasks
Copy
Ask AI
Search Column: PrioritySearch Value: HighResult: Only returns tasks marked as exactly "High"
Finding Orders by Status
Copy
Ask AI
Search Column: Order StatusSearch Value: ShippedResult: Only returns orders with status exactly "Shipped"
No Filtering
Copy
Ask AI
Search Column: No Search ColumnResult: Returns all records (no filtering)
Requires Authentication with Airtable - Set up in the Credentials page
Output type changes from list to text when Number of Records = 1
Search parameters are case-sensitive and require exact matches
View selection can impact available records and columns
Row Range cannot start with row 1 (headers)
Search Column and Search Value must match exactly (no partial matches)
After modifying fields in your Airtable table, click the refresh button (🔄) next to the Table dropdown to update the available field inputs in Gumloop
In summary, the Airtable Reader node provides flexible ways to fetch and filter data from Airtable, with output formatting that adapts to your needs. Whether used as a standard node or trigger, it forms the foundation for many automation workflows involving Airtable data.