A Status field tracks where a record is in a process. Think of a label that moves from New to Resolved as the work moves.
Here is the test: does this record go through stages, and does one stage mean the work is done? If yes, you want a Status field. A Single Select field holds a choice too, but it has no "done" and cannot feed My Work.
Example: an Incidents table with a field called Incident Status. Its statuses are New, Triage, Investigating and Resolved. Resolved is marked complete, so the linked Due Date knows when an incident is closed.
The Incident Status field in an incident record, showing Investigating as a full-width colored bar with the chevron.
Plan Availability | All plan types. |
Permissions | Solution Managers and Workspace Administrators can create, modify and manage Status fields. |
Platform | Web |
Related Reading |
Adding a Status Field Type
Every new table comes with a Status field already in it: Backlog, In Process, Ready for Review and Complete. It is linked to the table's Assigned To and Due Date fields. Edit that one, or add another for a second process.
In Grid View, select the + at the right end of the column headers. From an open record, select + Add new field to this Table at the bottom instead.
Select Status. You can type to search the list of field types.
Name the field. In this article it is Incident Status. A field name can hold up to 50 characters, and there is no restriction on the characters it can contain.
The field settings panel opens. It has four tabs: Settings, AI Field Agent, Defaults and Help Text. The rest of this article takes them in that order. Save at any point with Add Field (or Update Field on a field that already exists) and come back to the other tabs later.
The field settings panel, Settings tab, with Display Format, the four Statuses rows and Options.
Settings
The Settings tab holds the statuses and one rule. Top to bottom: Display Format, Statuses and Options.
Display Format
A preview of how a status looks: a full-width colored bar with the status name. There is nothing to choose. The bar is the only format for this field.
Statuses
Statuses are the stages a record can be in. The field starts with four: Backlog, In Process, Ready for Review and Complete.
Select a name to edit it. For Incident Status, rename them New, Triage, Investigating and Resolved.
Select the color circle to pick another color from the 40 available.
Hover over a row to see + (insert a status below) and - (remove the status). + Add New Status adds one at the end.
Drag a row by its handle to reorder.
The circle at the right of a row is Mark as Complete. Select it on every status that means the work is finished.
The order you set here is the order people see in the dropdown. It is also the order of the groups when you group by the field, and the order of columns in Kanban View. For Incident Status that is New, Triage, Investigating, Resolved.
Note: At least one status must be marked complete. The Due Date field reads that mark to show an incident as done, and My Work uses it to clear the task.
The Statuses section with the four incident statuses, the color picker open on one row and the Mark as Complete circle filled on Resolved.
Options
Require an entry in this field. Off to start. On, the field shows a REQUIRED label and a record cannot be saved until a status is picked. The message reads "Value is required". Turn it on when every record must sit somewhere in the process. For Incident Status it is on: an incident with no status is an incident nobody is working.
Tip: Mark more than one status complete when a process has more than one ending. An Incidents table might close as Resolved or as Not an Incident; both can be complete.
AI Field Agent
Off by default. The field works fully without it. Turn it on to let SmartSuite AI set the status from instructions you write.
Connection: the AI credential the field uses. The field cannot be saved with the agent on until one is chosen.
Instructions: what you want the agent to do, in plain words, with at least one field from the record inserted as a variable.
Run Automatically: on, the agent runs each time the record is updated; off, it runs when you ask.
Example for Incident Status, with the Latest Update field inserted as a chip (shown here in bold): "Read Latest Update. If it says the fix is confirmed, set this field to Resolved. If it describes work in progress, set Investigating. Otherwise leave the field as it is." The agent picks from the statuses in the field. A person still reviews what the agent set. The AI Field Agent article covers connections and instructions in full.
The AI Field Agent tab turned on, with a connection, the instruction for Incident Status showing the Latest Update chip, and Run Automatically.
Defaults
Default Status is the status every new record starts with. It is set to the first status, Backlog, to begin with. Open the dropdown to pick another, or select the x to start new records with no status.
Note: Defaults apply to new records only. Records that already exist do not change when you set or change a default.
For Incident Status the default is New, so every incident starts at the top of the process.
Help Text
A note for the person filling in the record, up to 800 characters. Help Text Appearance shows it As A Tooltip (the default, behind an info icon next to the field name) or Below The Field Name (always visible).
Write it for someone who has never seen the field. For Incident Status: "Move the incident along as the work happens. Set Resolved only when the fix is confirmed."
Permissions
Two kinds of permissions apply to this field.
Field Permissions. Every field can carry its own permissions, which control who can see the field and who can edit it. Open the column menu and select Edit Field Permissions. Let the incident team set Incident Status while everyone else reads it. See Field Permissions.
Dynamic Record Permissions. A Status field can drive record-level rules: who can see or edit a record based on its status. A rule such as "records whose Status is Resolved are read-only for everyone but the incident lead" uses the field's statuses as the condition. Every field type except Button can drive a rule. See Dynamic Record Permissions.
Using the field in views and records
Once statuses are set, the field answers "where is this?" across the table. In a record or a grid cell, open the dropdown with the chevron and pick a status. The x clears it, unless the field is required. In Grid View, the Delete key clears it too.
A Status field also links two other fields. An Assigned To field points at it under Display in My Work, so each owner's incidents appear in their My Work list. A Due Date field points at it under Linked Status Field, so the due date shows a green check once the status is complete. If the date has passed and the status is not complete, it shows a red badge with the number of days overdue. See Assigned To Field and Due Date Field.
Filtering
The operators are is, is not, is any of, is none of, is empty, is not empty, is completed and is not completed. "Incident Status is not completed" lists every open incident, whatever stage it is at. Spotlight uses the same operators, and Find searches the values.
Grouping
Group a view by the field and each status becomes a group, in the order you set under Statuses. In Kanban View the statuses become the columns, and dragging a card to another column changes its status. See Kanban View.
Sorting
Sort First → Last or Last → First from the column menu. Records order by the position of their status, not by its name.
Counting and rolling up
The field works in Lookup fields, in the filters of Count, Rollup and Lookup fields, and in Auto-Generated Titles. A Count field on a Systems table can count the open incidents linked to each system by filtering on Incident Status is not completed. In Grid View, the footer of the column can show a bar with the share of each status.
Formulas
A formula reads the field as the status name. This one flags incidents that need attention:
IF([Incident Status] = "Triage", "Needs owner", "")
Automations
A status change is a common trigger. When Incident Status changes to Resolved, an automation can email the person who reported it. An action can also set the status, such as setting every new incident to New. See Automation Actions explained.
Forms
A Status field can be placed on a form. See Form View.
Editing a Status field
Add a status. Open Modify Field Settings, select + Add New Status or the + on a row, name it, then Update Field. Existing records keep their status.
Rename a status. Select the name under Statuses, type the new one and select Update Field. Every record that held the old name shows the new one.
Change which status is complete. Select the circle on another row. The Due Date field and My Work follow the new mark.
Remove a status. Hover over the row, select -, then Update Field.
Note: Removing a status clears it from every record that held it, and those records are left with no status. Group a view by the field first to see how many records that is.
Change the field type. The dropdown at the top of the panel changes the type. See Changing a Field's Type.
Frequently asked questions
When should I use Single Select instead?
When should I use Single Select instead?
When the choice has no "done" and the record is not a task. A vendor's tier is a Single Select. An incident's progress is a Status.
Why can I not clear the status in a record?
Why can I not clear the status in a record?
Require an entry in this field is on. Turn it off in Options, or pick another status instead.
Why are my records not in My Work?
Why are my records not in My Work?
The Assigned To field is not linked to this Status field. Open the Assigned To field settings and pick this field under Display in My Work.
Can more than one status mean complete?
Can more than one status mean complete?
Yes. Mark as Complete can be on for several statuses. Each one closes the task for the Due Date field.
Can I change the color bar to a pill or plain text?
Can I change the color bar to a pill or plain text?
No. The full-width colored bar is the only display format for a Status field.
What is the bar at the bottom of the column?
What is the bar at the bottom of the column?
The grid footer can show the share of records in each status, so you can see at a glance how much work is open.
Need more help? Ask the SmartSuite Community, where builders, administrators and the SmartSuite team answer questions about building on SmartSuite. For your account, billing or data, select the chat button in the lower-right corner of SmartSuite to reach support.
Last verified 1 Nov 2026.




