System Admin

System Administration Guide

Configure FlecBase for your business — user roles, record visibility, custom fields, subtypes, and workspace settings. For workspace owners and administrators.

Sections
Chapter 1

User Roles & Permissions

Understanding who can do what in your workspace.

1
Reference

The Four Roles

Every user in a FlecBase workspace has one of four roles. Roles control what they can see and do across both the CRM and the mobile app.

Capability Owner Admin Staff Field User
Access CRM (web)
Access mobile app
View all records
View own + shared records
Create records
Upload files & photos
Complete prestarts
Download PDF reports
Manage team members
Invite users
Workspace settings
Billing & subscription
Delete workspace

Owner

The person who created the workspace. Full control over everything including billing and workspace deletion. There is one owner per workspace.

Admin

Trusted team members who can manage users, configure settings, and access all records. They can do everything except manage billing or delete the workspace.

Staff

Day-to-day operators. Full CRM and app access, can see all records, create content, and run reports. Cannot manage users or settings.

Field User

App-only access. Designed for contractors, technicians, and field workers who need to capture data but don't need the full CRM. They see only records shared with them or created by them.

Team Page with Role Badges Screenshot
2
CRM

Changing User Roles

Owners and Admins can change any user's role from the Team page or from a Person record in the CRM.

From the Team page: Click Edit on the user → change their role → Save.
From a Person record: If the person is linked to a user account, you'll see a Change Role button in the record header.
Promoting a Field User to Staff gives them full CRM access and visibility of all records. Demoting a Staff member to Field User restricts them to app-only access and their own records. Changes take effect on next login.
Chapter 2

Record Visibility

How records are shared and who can see what.

3
Reference

Visibility Model

FlecBase uses a simple visibility model based on user role and record ownership.

Staff, Admin, Owner — See Everything

Users with CRM access can see all records in the workspace, regardless of who created them. There are no record-level permissions for CRM users — if you're staff or above, you see the full picture.

Field Users — See Own + Shared

Field Users can only see records they created themselves, or records that have been explicitly shared with them. This means a contractor working for your client only sees the specific assets, inspections, and orders assigned to their work — not your entire database.

Sharing Records with Field Users

Records are shared with Field Users through the visibility setting on each record. Set a record to "shared" and assign it to a user group, and all Field Users in that group will see it in their app.

Records created by a Field User are automatically visible to all CRM users (Staff, Admin, Owner) — the data flows up.

Record Visibility Setting Screenshot
Workspace isolation is absolute. Users with access to multiple workspaces (e.g. a contractor working for two clients) see completely separate data in each workspace. There is no data leakage between workspaces.
Chapter 3

Subtypes — Tailoring the Experience

How subtypes make the mobile app less cluttered and more useful.

4
Reference

What Are Subtypes?

Every entity type (Person, Asset, Order, etc.) can have subtypes — more specific categories that control which fields appear on the mobile app. This means a "Vehicle" asset shows different fields than a "Building" asset, even though they're both assets.

Why Subtypes Matter

Without subtypes, every asset record shows every possible field — purchase price, warranty expiry, serial number, last service date, and dozens more. Most of those fields are irrelevant for a given asset type. Subtypes let you show only what matters.

Default subtypes are pre-loaded when your workspace is created. Common examples:

Entity TypeExample Subtypes
PersonEmployee, Contractor, Customer, Supplier Contact
OrganisationClient, Supplier, Branch, Government
AssetVehicle, Building, Equipment, IT Hardware, Tool
OrderWork Order, Service Job, Purchase Order, Quote
EventSite Visit, Meeting, Training, Delivery
IncidentSafety Incident, Damage Report, Complaint, Near Miss
InspectionSafety Inspection, Condition Assessment, Compliance Check
Subtype Selection on APP Screenshot
5
Reference

How Subtypes Drive the APP

When a field worker creates or opens a record, the subtype controls which fields they see. This is driven by the Attribute Registry — each field definition can be scoped to a specific subtype.

Example: Asset Subtypes

A Vehicle subtype shows: make, model, registration, odometer, tyre condition, last service date, next service due.

A Building subtype shows: address, floor area, construction year, fire rating, last inspection.

Both are "assets" — but the field worker sees only the fields relevant to what's in front of them. Less clutter, faster data entry, fewer mistakes.

The CRM always shows all fields regardless of subtype — subtypes only filter what appears on the mobile app. This means CRM users always have the complete picture while field workers get a streamlined experience.
Chapter 4

Custom Fields (Attribute Registry)

Extend FlecBase with fields specific to your business.

6
CRM — Admin or Owner

How Custom Fields Work

FlecBase comes with built-in fields for each entity type (name, email, serial number, etc.). But every business is different — you might need to track a vehicle's fuel type, an asset's insurance policy number, or a person's security clearance level.

The Attribute Registry lets you define custom fields that appear in both the CRM and the mobile app. Custom fields are configured per entity type and optionally scoped to a specific subtype.

Navigate to Settings → Attribute Registry in the CRM (Admin or Owner only).
Create a new attribute. Set the field key, display name, data type, and which entity type it belongs to.
Choose where it appears. Primary fields show in the main details section. Extended fields go in a collapsible section below.
Scope it optionally. Leave subtype scope blank to show on all subtypes, or set it to a specific subtype (e.g. "vehicle") to show only on Vehicle assets.
Attribute Registry List Screenshot
7
Reference

Field Types

Custom fields support several data types:

Data TypeUse ForExample
TextFree text inputPolicy number, registration plate
NumberNumeric valuesOdometer reading, floor area (m²)
DateDate pickerInsurance expiry, certification date
BooleanYes / No toggleHas fire extinguisher, is compliant
SelectDropdown from defined optionsFuel type (Petrol / Diesel / Electric / Hybrid)
8
Reference

Field Placement & Sections

Custom fields are organised using two controls:

Primary vs Extended

Primary fields (is_primary = Yes) appear in the main details section of the record — alongside built-in fields like name, email, and serial number. Use this for fields your team fills in every time.

Extended fields (is_primary = No) appear in a collapsible "Extended Fields" section below the main details. Use this for fields that are important but not needed on every interaction.

Section Labels

Group related fields under a section header. For example, all vehicle-specific fields might go under a "Vehicle Details" section, while insurance fields go under "Insurance & Compliance". Set the section_label on each attribute to group them.

Custom Fields with Section Headers on APP Screenshot
Published vs unpublished: Fields marked as is_published = Yes appear in both the CRM and the mobile app. Fields marked is_published = No appear in the CRM only — useful for internal-only data that field workers don't need to see.
Chapter 5

Workspace Settings

Global configuration for your workspace.

9
CRM — Owner or Admin

Settings Overview

The Settings page in the CRM sidebar (Owner and Admin only) controls workspace-wide configuration.

Workspace Name

The name that appears in the CRM header and in the app's workspace picker. Change it here if your business name changes.

Prestart Templates

Manage the prestart checklist templates available in your workspace. Create templates for different equipment types (vehicles, static plant, scaffolding, etc.) and attach them to specific assets.

Entity Subtypes

Add, rename, or archive subtypes for each entity type. When you add a new subtype, it becomes available in the app's subtype picker when creating records.

Workspace Settings Page Screenshot
Chapter 6

Multi-Workspace & Contractors

One login, multiple clients — how contractors and multi-site businesses work.

10
Reference

How Multi-Workspace Works

A single FlecBase user account can belong to multiple workspaces. This is designed for contractors and consultants who work for multiple clients, or businesses with separate divisions.

On login, if the user has two or more workspaces, they see a workspace picker screen.
Select a workspace to enter it. All data, settings, and team members are scoped to that workspace.
Switch Workspace from the Settings menu (app) or user menu (CRM) to jump to a different workspace without logging out.
Workspaces are completely isolated. No data, files, settings, or team members are shared between workspaces. Switching workspace is like logging into a completely separate system — with the convenience of one account and password.
Workspace Picker Screenshot

Contractor Scenario

A plumber works for ABC Property Management and XYZ Real Estate. Both clients invite the plumber as a Field User via FlecBase. The plumber logs in once and sees both workspaces. They switch between them as needed — seeing only the properties and work orders each client has shared with them.

Chapter 7

Data Management & Compliance

File retention, compliance, and keeping your data clean.

11
Reference

File Retention

FlecBase automatically manages file retention based on Australian workplace health and safety requirements.

Record TypeFile RetentionBasis
Incidents & Inspections7 years minimumAustralian WHS legislation
All other records90 days after deletionStandard business practice

When a file is deleted, it enters a soft-delete state. It remains recoverable for the retention period, after which it's permanently purged. Workspace owners can place a legal hold on the workspace to pause all file purging during audits or disputes.

Prestart completions and incident records are never fully deleted — they are archived for compliance purposes. This protects both your business and your workers in the event of a safety investigation.
12
CRM — Ctrl+K / Cmd+K

Global Search

Use Ctrl+K (or Cmd+K on Mac) anywhere in the CRM to search across all entity types. Results show rich cards with the entity name, type, key details, and parent record — so you can quickly find the right record without navigating through menus.

Global Search Results Screenshot
13
CRM — Reference

Status & Priority Filters

Every record has a status and optionally a priority. The CRM list views filter by status by default — active records are shown, archived and deleted records are hidden.

Entity TypeDefault StatusAvailable Statuses
Person / Org / AssetActiveActive, Inactive, Archived (+ Disposed for Assets)
Order / Event / InspectionWorking On groupDraft, Open, In Progress, Complete, Cancelled
IncidentWorking On groupDraft, Open, In Progress, Resolved, Cancelled

Priority (Low, Normal, High, Critical) is available on work records — Orders, Events, Incidents, and Inspections. Use it to flag urgent work for your field team.

Status Filter Dropdown Screenshot
Previous Android Install