Documentation / Organizations & members
Organizations and workspaces
An organization is the tenant boundary in FieldKeel. One account can own or join many workspaces; each has its own subscription.
Organization as tenant
#FieldKeel is multi-tenant from day one. An Organization is the commercial customer of FieldKeel and the isolation boundary for operational data. Clients, sites, teams, jobs, files, timesheets, approvals, reports, and subscription usage all live under one organization.
Lookups are always scoped to the active organization. Wrong-tenant identifiers return not found rather than leaking existence across companies. Platform SUPER_ADMIN routes are separate and do not casually browse tenant jobs or files.
Accounts and membership
#A FieldKeel account is a platform identity. Organization role is never stored on the account itself. Membership links an account to an organization with exactly one org role for that membership: OWNER, ADMIN, OPERATIONS_MANAGER, SUPERVISOR, or TECHNICIAN. Soft-deactivate memberships when people leave so history stays intact.
Multi-organization membership is first-class. After login you select which organization to work in. Frontend org id or slug is selection only — authorization always reloads an active membership on the server.
Creating a workspace
#Workspace names do not need to be globally unique. Different businesses may use the same organization name. However, you cannot create two workspaces you own with the same name.
The workspace URL/identifier is generated automatically and remains unique, so two unrelated companies can both be called ABC Electrical without colliding in the product.
Additional workspaces
#A FieldKeel account receives one eligible free trial. Owners may create additional workspaces from Create workspace, with up to 3 awaiting activation at one time. Activate or delete a pending workspace to free a slot. There is no standard limit on activated workspaces. Additional workspaces do not receive another free trial — they remain read-only until activated. The Owner can activate the workspace through Billing (Activate Workspace).
One FieldKeel account can belong to many organizations and can also own multiple organizations. You can manage ABC Electrical and ABC Plumbing from the same FieldKeel account, but each workspace has its own plan, users, storage, and billing. Invited organizations do not consume your personal free-trial eligibility or pending workspace allowance.
FieldKeel may send account, billing, maintenance, or important service messages to Owners. Open Inbox even if a workspace is temporarily read-only.
Subscription and settings scope
#Plan, trial dates, seat usage, and storage quota are organization-scoped. Settings such as timezone, evidence rules, and requireGps also belong to the organization. Changing organization in the switcher changes which subscription and settings apply — workspaces never share a pooled plan.