← All docs

Multi-site / facility walkthrough

Multiple buildings, multiple staff, role-scoped access.

Personas
multi-site

Multi-site / facility walkthrough

You run more than one building (or want to logically separate areas) and need staff to only see the animals they're responsible for.

Required plan

Multi-site is a Apex plan feature. Hatchling / Juvenile / Adult / Colony accounts have a single implicit "Main" site.

Setup

1. Define your sites

Go to /sites+ Add site. Give each one a name and optional address ("Main facility", "Quarantine room", "Off-site breeding building").

2. Move enclosures into sites

Each enclosure can belong to one site. Set this on the enclosure form. Existing enclosures default to your "Main" site.

3. Invite staff

Go to /users+ Invite member. Pick a role:

RoleCan do
ViewerRead-only; no logging
EditorLog feedings, weights, sheds, events
AdminEditor + manage species, enclosures, animals; cannot delete data
OwnerEverything including billing and member management

You can also assign which sites a user can see. Editors and viewers will only see enclosures and animals at their assigned sites.

4. Lock down QR actions

By default, scanning a QR on a printed label lets anyone with the URL log a feeding (this is on purpose — fast at the rack). For higher-stakes actions (cleanings, custody changes), require login per-action under Account → QR & quick actions.

5. Audit log

Every create / update / delete is logged. Owners can review at /audit-log and filter by user, action, or target type.

Tips for facility ops

  • Custom event types — define your own ("Quarantine release", "Vet inspection", "Weighed for shipment") under Account → Event types.
  • Notifications — wire up a Discord webhook so account creations and support requests show up in your team channel. See Notifications.
  • Branded emails — Colony and above accounts can override the outbound From address and logo on transactional emails.