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.
Creating multiple workspaces
#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. Only the first self-created trial workspace receives the free 14-day Professional trial. Additional workspaces you create require their own subscription.
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.