Company codes and identifiers explained
Published:
Updated:
This article explains the three identifiers MobilityManager uses to distinguish companies (tenants) — the internal ID, the code, and the name — and how to change them safely.
The three identifiers
Every company carries three pieces of identity, each with a different purpose:
| Identifier | Set by | Purpose |
|---|---|---|
| ID | The system, automatically | A numeric key used internally to link data. You do not choose or edit it. |
| Code | You, at creation | A short unique text identifier (up to 100 characters) that users select at sign-in and that single sign-on uses to find the company. |
| Name | You, at creation | The human-readable display name of the organization (up to 200 characters). It does not need to be unique. |
Why the code matters
The code is the identifier users and integrations work with:
- At sign-in, the platform looks up available companies by their code to determine which login options (local password or SSO) to show.
- Single sign-on (OIDC) requests reference the company by its code, so a stable code keeps SSO working.
- The code must be unique across the whole installation. If you try to create or rename a company to a code that already exists, the operation is rejected with a message that a company with that code already exists.
Tip: Choose a short, stable code that reflects the organization (for example an abbreviation) and avoid changing it once users and SSO rely on it.
Changing a company's name or code
Renaming or re-coding a company is a system-level operation. It requires the tenants:edit permission and is restricted to a SystemAdmin.
- Open the company (tenant) management area and select the company.
- Edit the Name and/or Code.
- Save. If you changed the code, the platform verifies the new code is not already used by another company before applying it.
Warning: Changing the code affects how users sign in and how single sign-on identifies the company. If SSO is enabled, update the identity provider configuration to match the new code, and inform users so they select the correct company at the login screen.
Where you see each identifier
- The name appears in the company switcher, dashboards, and reports.
- The code appears on the sign-in screen and in SSO configuration.
- The ID is used behind the scenes and generally is not shown to end users.
Related
- Creating a new company
- Understanding companies and data isolation
- Switching your active company
- How each company's database works
AH
