Configuration

Everything an organiser configures from the back-office. Nothing here requires a code deploy — it's all forms in Settings.

Tenant settings

Settings → General Settings → Festinato

Field	What it controls
Display name	The festival name as shown in the app, the portal and outbound email.
Default locale	The language new admin users land in. Editions can override per-edition.
Time-zone	Drives push-notification scheduling and slot times.
Currency	Used for box office, donations and artist payouts.
Logo	Square PNG — appears in the app splash and the back-office chrome.
Primary colour	Single hex value. Drives the mobile app accent and the portal brand chip.
Contact email	Shown to attendees in the app "About" page and on legal pages.

Editions

Festinato → Editions

An edition is one running of the festival. Most settings live here rather than on the tenant — so you can change them year over year without touching the rest.

• Start / end dates — drive the schedule view's range.
• Publicly discoverable — adds the edition to the Festival Hub picker. Available on Community tier and above.
• Hub group — optional. Group several editions under a curated Hub build (e.g. "Swiss summer festivals") so a custom Hub shows only those editions.
• Programme PDF template — choose layout + paper size for the print export.

Branding

Settings → General Settings → Festinato → Branding

Three values are enough to brand the mobile app:

• Primary colour — hex.
• App icon — 1024×1024 PNG.
• Splash image — 2048×2048 PNG with a transparent background.

For a fully branded build (your own bundle id, your own App Store listing) raise a request with your account manager — they trigger the white-label build and deliver the signed artifacts to your developer accounts.

Push notifications

Settings → Technical → System Parameters — the keys below configure push delivery. They're set on provisioning and rarely need to change.

Parameter	Meaning
push.fcm_service_account_json	The Google service-account JSON for FCM (Android).
push.apns_team_id	Apple Developer team id.
push.apns_key_id	APNs key id.
push.apns_p8	The .p8 key contents.
push.apns_bundle_id	The mobile app's bundle id.

The Festival Hub fan-out uses Festinato's own credentials — you only need the keys above if you ship a branded app.

Outbound email

Tenant lifecycle emails (welcome, password reset, retention warning), volunteer portal links, and Mollie receipts route through Festinato's shared relay by default. No configuration is required.

To send from your own domain (e.g. noreply@your-festival.ch):

1. Raise a request with your account manager.
2. Publish the SPF, DKIM and DMARC records they send back.
3. They flip the Mail from address on your tenant.

Lifecycle email templates can be edited from Settings → Technical → Email Templates without a code deploy — useful for tweaking the welcome copy or translating into a fifth language.

Custom domain

Professional tier and above.

1. Pick the hostname you want — typically app.<your-festival>.tld.
2. Add a CNAME record from that hostname to <tenant_id>.festinato.app.
3. Mail your account manager — they add the domain on the edge so a certificate is issued on first request.

After ~30 seconds the certificate is live and your app, portal and API all answer on the new name. The original <tenant_id>.festinato.app keeps working as a fallback.

Roles and access

The seeded admin user can do everything. From Settings → Users & Companies → Users you can add:

• Organiser — full back-office access for the festival team.
• Programmer — can edit artists, venues and slots, nothing else.
• Volunteer coordinator — shifts, briefings and volunteer roster.
• Read-only — for board members, accountants, council reviewers.

Two-factor authentication is enforced on the admin role by default and can be required for any other role from the same screen.

Languages

Settings → Translations → Languages

German, French, Italian and English are activated on every tenant. Additional languages: activate the language, then visit the records you want to translate — a small flag at the top of each form lets you switch the input language.

Data export

GET /api/v1/export produces a portable archive of your catalogue (editions, artists, venues, slots, news, sponsors, fundraising, volunteers and push devices). Useful for:

• Migrating between tenants or environments.
• Handing the catalogue to a developer building a third-party widget.
• Year-on-year archival.

See the API reference for the exact shape.

Cancellation and retention

Cancel anytime from Mollie's customer portal. The current paid year runs to its end; on expiry the back-office goes read-only and the data is retained for 90 days before deletion. Within that window you can export, restore, or resume your subscription. After 90 days the tenant and all attached media are permanently deleted.

To request immediate deletion mail privacy@festinato.app.