feature

New Feature: Rename the Words Your Airtable Portal Uses

Set what one row is called on any table and your portal rewrites itself around it, from the create button to the delete prompt to the empty state.

Matt Shepherd
By Matt Shepherd, Founder, CollabPortals
· 4 min read

Your portal is not about records

Out of the box, a CollabPortals portal talks about records. The button says "New". The delete prompt asks "Delete record?". An empty table reads "No records to display."

Nobody's portal is about records. A maintenance portal is about jobs. A claims portal is about claims. A recruitment portal is about applications. Your users already have a word for the thing they are looking at, and "record" is a word from the tool, not from their work.

You can now set that word yourself, per table, on a new Labels tab.

One setting does most of the work

Set what one row is called and the portal rewrites itself around it. Set it to "job" and:

  • "Create New Record" becomes "Create New Job"
  • "Delete record?" becomes "Delete job?"
  • "Record deleted" becomes "Job deleted"
  • "No records to display." becomes "No jobs to display."
  • The view, edit and delete buttons on each row announce themselves to screen readers as "View job", "Edit job" and "Delete job"

That last one matters more than it looks. If the buttons say one thing and the screen reader says another, anyone using assistive technology gets a portal that disagrees with itself. The accessible names follow the word you set, so they do not.

Here is a portal before, with the built-in wording:

A portal Work Orders page with a New button in the top right and a Kanban and List view switcher below it
Before: the built-in wording.

And after, with the record name set to "job" and the create button set to "Log a job":

The same portal page, now with a Log a job button and a Pipeline and Full list view switcher
After. Same data, same layout, different words.

The rest of the buttons

The record name is the setting that does the heavy lifting, but each of these can be set on its own:

  • The create button, which is "New" by default
  • The submit button on the create form and on the edit form, separately
  • The "Details" tab on a record page
  • The heading shown when a record has no name yet
  • On a calendar table: the Month, Week and List buttons, and the Today button
  • On a kanban table: the board and list buttons

Every box is optional, and an empty box shows the wording your portal will use in grey. So you only fill in what you want to change, and you can always see what you are getting.

The Labels tab for a Work Orders table, with job and jobs filled into the record name boxes, Log a job in the create button box, and Pipeline and Full list in the view buttons
The Labels tab. Filled boxes show in black, the greyed-out text is the default you get if you leave a box empty.

One detail worth knowing: you set the singular and the plural separately. Type the singular and we fill in the plural with an "s" on the end, which is right for jobs and claims and wrong for boxes, people and entries. It goes in the box next to it so you can see it and fix it.

Renaming the view buttons

Calendar and kanban tables let your users switch how they see the data, and those buttons have their own labels. This is where "List" gets renamed, which is the request that started this off.

A portal Visits calendar page with a Book a visit button, and a view switcher reading Month, Week and Agenda alongside a Jump to now button
A visits calendar with List renamed to Agenda and Today renamed to Jump to now. Month and Week were left alone.

If your calendar is a schedule of visits, "Agenda" or "All visits" reads better than "List". You only see the boxes for the view your table actually uses.

Who this helps

Anyone handing a portal to people outside their team, where the wording is part of how professional it looks.

It also helps if you run several portals from one Airtable base. Labels are set per table and per role, so the same underlying data can be described differently to different audiences.

How it compares

If you build the same thing in Airtable Interfaces, your users are inside Airtable, seeing Airtable's own chrome and terminology, and they need a seat to get there. A portal you hand to an external user is a different surface, and the words on it are yours to choose.

Most portal builders let you name things somewhere. What we have tried to get right here is the amount of work it takes: one word, set once per table, and about twenty strings follow it, including the ones you would not think to go and find. See how the rest of the setup compares in our Softr comparison.

Getting started

Open your portal in the admin, expand a table, and switch to the Labels tab next to Access and Display. Set what one row is called, press Save, and reload the portal.

Full details, including how labels work with roles and what they do not change, are in the Labels documentation.

Let me know how you get on, or if there is a word somewhere in the portal you still cannot change.