Syndicate settings — overview
What it is
Section titled “What it is”The Syndicate Settings hub is the admin-facing entry point for every configuration that lives on the syndicate as a whole. It is a grid of six navigation tiles plus a link back out. Editing the syndicate’s name, description, or deleting the syndicate itself is reached from a separate pencil icon on the syndicate detail screen, not from the Settings hub.
The hub is visible only to owners and admins. Members see the syndicate detail screen but do not see the Settings entry.
Who can use it
Section titled “Who can use it”- Owner and admin — full access to all six tiles.
- Members — no access to the Settings hub. Individual settings screens enforce role checks at the server level in addition to the UI hiding them.
Where to find it
Section titled “Where to find it”In the app:
- Open the syndicate.
- Go to Dashboard → Syndicate settings (admin/owner only).
Route: /syndicates/:syndicateId/settings.
For Edit Syndicate, use the pencil icon next to the syndicate name at the top of the syndicate detail screen. Route: /syndicates/:syndicateId/edit.
Fields / options
Section titled “Fields / options”The Settings hub contains six tiles:
| # | Tile | What it covers | Reference page |
|---|---|---|---|
| 1 | Subscription | The syndicate’s paid-or-free tier, asset limit, payment state. | Subscription pricing |
| 2 | Booking Policy | Require booking approval, minimum booking duration, max advance booking days, require admin confirmation for squawks. | Booking Policy |
| 3 | Privacy & Visibility | Show member names on bookings, usage log visibility, share usage photos. | Privacy and visibility |
| 4 | Billing & Rates | Usage rate, shortfall rate, minimum usage, event fees, usage capture, per-scheme rates. Single- and multi-asset behaviour differ — see the page. | Billing and rates |
| 5 | Payments & Schemes | Currency, fuel and oil units, billing scheme definitions. | Payments and schemes |
| 6 | Import Data | CSV import wizard for bookings from Goboko or a generic CSV. | Goboko CSV format · Generic CSV format |
Separately, from the syndicate detail screen:
| # | Where | What it covers | Reference page |
|---|---|---|---|
| 7 | Edit syndicate (pencil icon) | Name, description, delete syndicate. | Edit syndicate |
Behaviour rules
Section titled “Behaviour rules”- Admin-only hub. Members cannot reach the Settings hub. Every sub-screen also enforces the role check at the server level via Row Level Security.
- Navigation never leaves the syndicate context. All six tiles route under
/syndicates/:syndicateId/...so a breadcrumb always tells the user which syndicate they are configuring. - Single-asset vs multi-asset matters on Billing & Rates only. See Default and per-asset settings for the cascade. The other five tiles show the same fields regardless of asset count.
- Edit syndicate is separate on purpose. The Settings hub is for operational configuration. The syndicate’s identity (name, description) and its destruction are behind a different UI entry point so they are not accidentally clicked during day-to-day settings work.