Blog

TMS User Roles: A Practical Admin Guide to Access and Permissions

TMS user roles are role-based access templates that determine which screens, modules, and actions each person in your system can use. The fastest path to a secure setup is a four-level access model, Admin, Full Access, Read-Only, and No Access, applied through role groups rather than individual accounts. Before rolling any change out company-wide, create a test user for each role and confirm what they can actually see and touch.


TL;DR:

  • Most companies should start with a four-level access model—Admin, Full Access, Read-Only, and No Access—applied through role groups rather than individual accounts.
  • It is essential to create and test a dedicated user for each new role to verify permissions before full deployment, avoiding inheritance errors that can cause security issues.
  • Permissions should be set top-down in a parent-child hierarchy, with careful attention to how No Access on parent modules automatically restricts all sub-screens.
  • Regular quarterly reviews of role permissions and a formal onboarding and offboarding process are vital to prevent permission drift and ensure security compliance.
  • FreightSuite integrates role-based access controls directly into its platform, supporting scalable and secure TMS deployment from the start.

Table of Contents

What Are TMS User Roles, and Why Do They Matter?

Every transport management system runs on the same basic logic: a person’s job function determines what they’re allowed to do inside the software. TMS user roles are the mechanism that enforces that logic. Instead of granting permissions one screen at a time to every new hire, you build a role, such as Dispatcher or Finance Manager, load it with the right permissions once, and assign people to that role as they join or change positions.

Get this wrong and the consequences aren’t abstract. A driver coordinator with edit rights to invoicing can accidentally alter a customer’s bill. A sales rep with full financial access can see margin data that should stay with accounting. Poor role design is also one of the fastest ways to fail a security audit, since auditors specifically look for who can touch money, contracts, and customer data.

The five roles below cover most freight and trucking operations, though your company size and structure will shape the specifics.

  • Administrator: Manages system configuration, integrations, and user accounts. Should be the smallest group in your organization, often just one or two people.
  • Dispatcher: Edits routes, assigns drivers, and manages live tracking, but rarely needs invoicing access.
  • Finance/Accounting: Handles billing, invoicing, and cost reports, with no route-editing rights.
  • Sales: Creates orders and adjusts pricing, but shouldn’t see full financial reporting.
  • Super user: A power user with broad operational access but not full system configuration rights, often used for regional managers who need visibility across teams without touching integrations or security settings.

Default templates work fine for most companies starting out. Build a custom role only when a job function genuinely straddles two categories, like a dispatch supervisor who also approves carrier invoices. Super users differ from administrators in one key way: administrators can change how the system works, while super users work within it at a higher visibility tier than standard staff.

What Do the Four Permission Levels Actually Control?

Nearly every modern TMS, including FreightSuite, organizes permissions around four access levels. Understanding these before you touch a single toggle will save you hours of troubleshooting later.

  1. Admin: Full control over a module, including the ability to change settings, delete records, and manage other users’ access to that same area. Example: an IT administrator who can reconfigure the customs brokerage workflow.
  2. Full Access: Complete ability to view, create, and edit records within a screen, but without configuration rights. Example: a dispatcher who can edit route status and reassign drivers all day but can’t change how the routing module itself functions.
  3. Read-Only: View records without editing them. Example: a sales rep who can see shipment status to update a customer but can’t alter the route.
  4. No Access: The screen or module is invisible to that user entirely. Example: a guest partner account with no visibility into internal cost data.

Here’s the part that trips up most administrators: these levels don’t operate in isolation. TMS platforms enforce parent-child inheritance rules, meaning if a parent module is set to No Access, every child screen underneath it is automatically forced to No Access too, regardless of what you set at the child level. According to Accruent’s TMS permissions documentation, this binding relationship is a common source of configuration errors precisely because it’s not always visible until you check.

In the interface, expect a tree view listing modules and sub-screens, with Admin/Full/Read-Only/No Access buttons next to each. A Permissions Summary view shows the net effect of your settings across the whole tree, and a Reset All function lets you return a group to Full Access if you need to start over. Always build your tree top-down, setting parent permissions before diving into individual screens, or you’ll spend time debugging why a permission you set never took effect.

Which Permissions Should Each Role Actually Get?

Role templates only work if the permissions inside them match real job responsibilities. Here’s how the five common roles typically break down across modules.

  • Admin: Full or Admin-level access to system configuration, user management, security settings, and audit logs. This is the only role that should touch integrations or billing rule changes.
  • Operations/Dispatcher: Full Access to route editing, stop management, and driver assignment. Route permissions are often split into distinct view and edit rights, things like viewing driver paths, adding stops to a route, assigning drivers, and editing route status, which lets you grant visibility to one team without handing them edit control.
  • Finance/Accounting: Full Access to billing, invoicing, cost tracking, and financial reports. No route-edit rights at all, since finance staff editing live routes creates operational confusion, not oversight.
  • Sales: Full Access to order creation and pricing updates, but Read-Only or No Access on deeper financial controls like margin reports or credit terms.
  • Guest/Read-Only: View-only access to a narrow slice of reporting, commonly used for external partners or customers checking shipment status without touching internal data.

That view/edit split matters more than it looks. Splitting route permissions this way lets operations share visibility with a customer-facing team without exposing edit rights to people outside dispatch, a pattern that shows up repeatedly in TMS permission structures.

Pro Tip: Build a simple role matrix before you touch the software, a spreadsheet with job functions as rows and modules as columns. It becomes your audit artifact later, and it forces you to catch overlap between roles before you’ve assigned a single account.

Role matrix spreadsheet on digital tablet

How Do You Set Up and Test a New Role?

Configuring TMS user roles isn’t complicated, but skipping the testing step is where most administrators get burned. Follow this sequence for every new role you create.

  1. Create the role and name it clearly (avoid vague labels like “Team 2”).
  2. Assign the role to the correct user group so permissions apply consistently across everyone in that function.
  3. Open the permission tree and set module and screen-level access, working top-down to respect parent-child dependencies.
  4. Save the configuration and immediately open the Permissions Summary to confirm the net result matches your intent.
  5. Create a dedicated test user account for the role rather than testing on a live employee login.

Once your test account exists, run through it methodically:

  • Log in as the test user and check the landing screen, it should show only what that role needs.
  • Attempt to edit a record that should be Read-Only. It should fail.
  • Attempt to view a sensitive financial screen that should carry No Access. It should be invisible, not just locked.
  • Check that route or dispatch functions behave as expected if testing an operations role.

Experts widely recommend this test-user step specifically because it catches inheritance mistakes that a permissions summary alone can miss. If something’s wrong, use Reset All to return the group to Full Access and rebuild from a clean baseline rather than chasing individual toggles. And if you’re rolling out a new invite-based workflow, most platforms handle this through a straightforward manage users flow, invite by email, assign the role, and send the invitation, with the same panel letting you edit roles or deactivate accounts later.

What Governance Habits Keep Permissions From Drifting?

Hands adjusting server rack switches

Role setup is a one-time project. Keeping it accurate is an ongoing discipline, and it’s the part most companies neglect until an audit forces the issue.

Adopt least-privilege as your default assumption: grant the minimum access a role needs to function, and expand only when a documented business reason exists. Schedule a permissions review every quarter, not just when something breaks. Build a formal onboarding checklist that ties new hires to existing role templates, and just as important, a deprovisioning workflow that deactivates access the same day someone leaves. Permissions left active for departed employees are a routine finding in security reviews.

  • Use Permissions Summary reports and activity logs as your primary audit tools, not manual spot-checks.
  • Keep a small number of sample test accounts, one per role, ready for quarterly verification.
  • Require documented approval, not a quick verbal okay, before granting any Admin-level access.
  • Log every permission change with the date, the approver, and the reason.
Governance habit Why it matters Suggested frequency
Least-privilege review Prevents permission creep across roles Quarterly
Onboarding checklist Ensures new hires match approved templates Per new hire
Deprovisioning workflow Closes access gaps from departing staff Same day as offboarding
Admin-grant approval Limits highest-risk access changes Per request

Changing a role’s permissions while people are mid-transaction can interrupt active workflows, a dispatcher losing edit rights mid-route update, for instance, so schedule permission changes during low-activity windows and warn affected users beforehand.

Where FreightSuite Fits Into Your Role Strategy

FreightSuite builds role-based access, group permissions, and audit visibility directly into its platform, so the four-level model and testing workflow described above aren’t a workaround, they’re how the system is designed to run from day one. Rather than bolting security onto legacy screens, FreightSuite treats permission structure as core to rate management, financial controls, and operations tracking alike.

FreightSuite

If you’re evaluating a TMS switch or setting up a new deployment, a demo is the right place to pressure-test this. Ask specifically about role templates for dispatch and finance, migration support for existing user structures, financial controls like credit limits and invoice approval chains, and permissions scoped for customs brokerage teams if that applies to your operation. FreightSuite’s road freight capabilities page and finance team solutions page both detail how role controls apply to specific functions. If your fleet also handles varied vehicle types, understanding delivery vehicle categories can help you decide how granular your dispatcher permissions need to be. Book a demo through FreightSuite to see the permission tree and role templates in action before you commit.

Your Next Steps for Rolling Out TMS Roles

Getting your role structure right doesn’t require a massive project, just a disciplined first pass.

  • Pick one pilot role, likely Dispatcher or Finance, and build its template first.
  • Create a dedicated test user and verify every permission before wider rollout.
  • Run the read/edit and sensitive-screen checks outlined above.
  • Schedule your first quarterly permissions review now, not after an incident forces it.
  • Browse FreightSuite’s resource library for deeper configuration walkthroughs, or reach out for support if you’re mid-migration.

Sources

FAQ

What Is the Difference Between Admin and Full Access?

Admin includes configuration rights and the ability to manage other users’ permissions within a module, while Full Access lets a person view, create, and edit records without changing how the system itself is configured.

How Many TMS User Roles Should a Small Company Create?

Most small freight operations run comfortably with four to five roles, Admin, Dispatcher, Finance, Sales, and a Read-Only guest tier, expanding only when a job function clearly doesn’t fit an existing template.

Why Does Setting a Parent Permission to No Access Affect Child Screens?

TMS platforms enforce binding parent-child inheritance rules, so a parent module set to No Access automatically forces every screen beneath it to No Access as well, regardless of individual settings.

How Do I Test a New Role Before Rolling It Out?

Create a dedicated test user account, log in as that user, and verify that read versus edit behavior, sensitive financial screens, and the login landing page all match what the role should see.

Does FreightSuite Support Role-Based Access Controls?

Yes, FreightSuite builds group permissions and role templates natively into rate management, operations, and finance modules, following the same four-level access model described throughout this guide.

Visibility
Operations

More from the blog

One Quarter Wins: AI in Freight Forwarding Inside Your TMS

Read article

Save 15 Hours Weekly: Logistics API Integration for Developers

Read article

Forwarders: Freight Forwarding Software Definitions Mapped by Module

Read article
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.