# Organisation settings

Source: https://bulwarkmail.org/docs/guides/organisation
Last updated: 2026-11-12

> Signatures, external mail warnings, sign-out times, shared templates and tags, delegates, announcements, device policies, and settings per domain or group.

The admin console's **Organisation** section holds the settings a company or a hoster makes for its users: what every message carries, what warns them, when they are signed out, and what teams share. Each page explains in one sentence what it does for users.

| Page | What it sets |
| --- | --- |
| [Domains and groups](https://bulwarkmail.org/docs/guides/organisation/domains-and-groups.md) | Different settings for some domains or groups, the effective policy of a user, the policy file |
| [Signatures](https://bulwarkmail.org/docs/guides/organisation/signatures.md) | The organisation signature with each user's details, and the legal disclaimer |
| Templates | [The template library every user sees, and what users may keep of their own](https://bulwarkmail.org/docs/guides/organisation/templates.md), [out-of-office reply templates](https://bulwarkmail.org/docs/guides/organisation/out-of-office.md#reply-templates) |
| Security | [External sender label, external recipient warning](https://bulwarkmail.org/docs/guides/organisation/external-mail.md), [sign-out times](https://bulwarkmail.org/docs/guides/organisation/sessions.md), [third-party traffic](https://bulwarkmail.org/docs/guides/organisation/third-party-traffic.md), [phishing reports](https://bulwarkmail.org/docs/guides/organisation/phishing-reports.md) |
| [Classification](https://bulwarkmail.org/docs/guides/organisation/classification-labels.md) | Labels users pick for outgoing mail (Internal, Confidential, VS-NfD), a default, whether a label is required |
| Sharing | [Tags in shared mailboxes](https://bulwarkmail.org/docs/guides/organisation/shared-tags.md), [delegates](https://bulwarkmail.org/docs/guides/organisation/delegates.md), [recovering deleted items](https://bulwarkmail.org/docs/guides/organisation/recover-deleted-items.md) |
| Calendars | [Company calendars](https://bulwarkmail.org/docs/guides/organisation/company-calendars.md), [free/busy sharing for Suggest times](https://bulwarkmail.org/docs/guides/organisation/find-a-time.md), [out-of-office blocks the calendar](https://bulwarkmail.org/docs/guides/organisation/out-of-office.md) |
| [Notices](https://bulwarkmail.org/docs/guides/organisation/announcements.md) | An announcement across the top of every app, and how long Trash and Junk keep mail |
| Devices | [No downloads, no export, no printing, no install prompt, push without sender and subject, a watermark](https://bulwarkmail.org/docs/guides/organisation/device-policies.md), [offline mode](https://bulwarkmail.org/docs/guides/organisation/offline-mode.md) |
| [Proofreading](https://bulwarkmail.org/docs/guides/organisation/proofreading.md) | Whether proofreading plugins check what users write: off, the users' choice, or required; per domain, group and plugin; the writing language |
| [Mail import and export](https://bulwarkmail.org/docs/guides/organisation/mail-import-export.md) | Stalwart's upload limit for migrations from mbox, PST and EML files, and turning export off |

Assigning messages in a shared mailbox and marking them done comes from the [Team inbox plugin](https://bulwarkmail.org/docs/guides/organisation/team-inbox.md), not from these pages. It isn't in the extension directory yet; you upload its ZIP under Extensions > Plugins.

Two official plugins add checks an organisation sets up under **Extensions > Plugins**, not on these pages: the [link check](https://bulwarkmail.org/docs/guides/organisation/link-check.md) of links when users click them (company service or Google Safe Browsing), and [send checks](https://bulwarkmail.org/docs/guides/organisation/send-checks.md) for IBANs, card numbers, keywords and attachment types before mail goes out.

Every setting has a default that works without configuration. An admin who does nothing gets Bulwark as before.

## Locking a setting

For 26 settings the admin can lock the value users get or hide the option, and each setting offers only what fits it. Users then see the admin's value with **Set by your organisation** next to a locked setting, instead of a control that does nothing. Two settings have a limit of their own: Notification duration takes a minimum, and Rights users can give can be limited to read access. Most of the 26 are on the User policy page; the Organisation pages list theirs next to the settings they belong to.

Many more settings can be preset: users start with the admin's value and can change it. The accessibility reading aids, such as text size, contrast and motion, are among them. They can be preset but never locked or hidden.

The tags new users start with are preset the same way, under **Tags** in the **Defaults** section, or as `defaults.emailKeywords` in `policy.json`: a list of `{ "id", "label", "color" }`, at most 50 entries, with colours from the tag palette. It replaces the seven colour tags for users who haven't changed their tags; an empty list gives new users none. Users who had tags before this version keep theirs. The tag list can't be locked.

## Everything is one file

All of it, and the User policy page, is stored in one file, `policy.json` in `ADMIN_CONFIG_DIR`. The one exception is the No third-party traffic switch on the Security page, which is a server setting in `config.json`. You can keep `policy.json` in git and mount it read-only, export it from one instance and import it on another, or put it next to a [Bulwark Lite](https://bulwarkmail.org/docs/getting-started/lite.md) build, which reads the same file. See [the policy file](https://bulwarkmail.org/docs/guides/organisation/domains-and-groups.md#the-policy-file). With [several instances](https://bulwarkmail.org/docs/deployment/multi-instance.md) on a shared store, the policy lives in the store unless you mount the file read-only, and a saved change reaches every instance within seconds. When two admins save the policy at the same time, the one who saves second is told that someone else changed it and keeps their edits until they reload.

> **Note.** Bulwark Lite has no admin console. Write `policy.json` by hand, or export it from a full Bulwark, and put it next to `index.html`. Lite applies the same domain and group settings.
