Return types
Return types are the labels your firm uses on engagements — “1040 Individual,” “1120S Corporate,” “OR-40 Oregon Individual.” They drive engagement defaults, dashboard filters, billing analytics, and merge tags in your letters.
To open them, go to Settings → Return types in the sidebar. You’ll see a flat table with inline edit — click a row to change its label or description without opening a separate dialog.
What ships out of the box
Assure Pro includes five built-in return types:
| Code | Label | Notes |
|---|---|---|
| 1040 | Individual | Personal federal return |
| 1120S | S-Corporation | S-corp federal return |
| 1065 | Partnership | Partnership federal return |
| 1041 | Trust / Estate | Trust and estate federal return |
| 990 | Nonprofit | Tax-exempt org return |
Built-in types can be renamed and described but not deleted. If you don’t file one, toggle it inactive instead.
Adding a custom return type
Click + New return type in the top-right. A dialog opens:
| Field | Notes |
|---|---|
| Code | Required. 1–12 characters, locked once saved. Examples: “OR-40”, “CA-540”, “1120F” |
| Label | Required. Plain English — “Oregon Individual,” “California Individual” |
| Description | Optional. Up to 500 characters — explain scope, deadlines, anything useful |
Click Create. The new type lands at the bottom of the list with Active turned on.
[Screenshot: New return type dialog]
Reading the table
The table has these columns:
- Code — left side, monospaced, locked once saved.
- Label — middle, click to edit inline.
- Active — switch, flips immediately when you toggle.
- Actions — Edit (always available) and Delete (custom types only).
- A (system) badge replaces the Delete action on built-in types.
Editing inline
Click any row’s label or description cell. The cell becomes an input. Type, press Enter or click outside to save. Press Esc to cancel.
| Cell | Editable inline? |
|---|---|
| Code | No (locked) |
| Label | Yes |
| Description | Yes (longer text area) |
| Active | Toggle |
Filtering the table
Above the table:
- Search — by code or label.
- Show inactive — toggle to include inactive types in the view.
Inactivating vs deleting
Inactive keeps the type in your records but hides it from:
- The Return type dropdown on the new-engagement form.
- Dashboard filters.
- New engagement defaults.
Engagements that already used this type keep working — the badge still shows, and merge tags still resolve.
Delete (custom only) removes the type entirely. If any engagements still reference it, the delete is blocked with a message like “X engagements still use this return type.” Inactivate it first, then delete.
Where return types show up
| Surface | What you see |
|---|---|
| New engagement form | The Return type dropdown pulls from this list (active only) |
| Engagement detail page | A badge in the header |
| Clients list | A filter — “Show only 1040 clients” |
| Workflow board | An optional grouping column |
| Engagement letter merge tags | The merge tag for return type resolves to the label |
| Reports (when shipped) | A slice for analytics |
Common patterns
Adding state return types
Most firms file state returns alongside federal. The typical pattern:
- Add a custom return type per state you file (“OR-40”, “CA-540”, “NY-IT-201”, and so on).
- When a client needs both federal and state, create two engagements under the same client — one per return type.
Specialty returns
If you file niche returns (1120-F for foreign corps, 5471 for foreign reporting), add them as custom types. Same flow.
Sub-categorizing 1040s
Some firms want to distinguish “1040 simple” from “1040 complex with K-1s” for billing. You can model that either as:
- Two custom return types (“1040-Simple”, “1040-Complex”), or
- A single 1040 type plus engagement tags for complexity.
Tags are more flexible since they can change as the engagement progresses.
Tips
- Keep all five built-in types active unless you genuinely don’t file them. They’re the most useful out of the box.
- Use uppercase codes with hyphens — “OR-40”, not “or40” — to match industry conventions.
- The description matters more than you think. When someone new on the team picks a return type, the description tells them what each one means.
What’s not here yet
| Return type to engagement letter mapping | Letters auto-pick by entity type, not return type. Roadmap. |
| Return type to organizer mapping | Same — organizers default by entity, not return. |
| Per-return-type billing tier | Set this up in the service catalog instead. |
| State e-file integration | Not in the current release. Return types are labels — e-file routing is roadmap. |
Permissions
| Action | Required |
|---|---|
| View | View firm settings |
| Add, edit, or delete | Edit firm settings |
| Toggle active | Edit firm settings |
Next
- Engagements overview — where return types get assigned.
- Tags — for cross-cutting labels not tied to return type.
- Pipelines & automations — return type can be a filter on auto-advance rules.