How do I manage the legal footer links?

Requires Basic

Short answer

Under Administration → Branding, section “Legal links (login footer + e-mails)”, you configure the URLs for Imprint, Privacy, Terms, Consumer information, and Cancel contract — and use the “Show in footer” toggle to control which of them are visible. The links appear in the login page footer and in every system e-mail (e.g., password reset, invitation).

Prerequisites

The five available link keys are fixed: imprint (Imprint), privacy (Privacy), terms (Terms), legal_info (Consumer information), cancel_contract (Cancel contract).

Open Branding. Administration → Branding → section “Legal links (login footer + e-mails)”.

Screenshot pending admin-branding-02 The 'Legal links' section with URL fields for Imprint, Privacy, Terms, and visibility toggles

The five legal links with URL fields and the 'Show in footer' toggle.
Enter the URLs. Fill in the Imprint URL, Privacy URL, Terms URL, Consumer-information URL, and Cancel-contract URL fields with the addresses of your own pages.
Choose visibility. Enable “Show in footer” for each link. Only links that are enabled and have a URL actually appear.
Save and check. Open the login page in a private window — the footer shows the enabled links in a fixed order (Imprint, Privacy, Terms, Consumer information, Cancel contract).

The legal links are fields of the instance settings. footer_links_enabled is a list that controls which keys are visible:

curl -X PUT https://demo.notory.io/api/v1/instance/settings \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "imprint_url": "https://acme.example/impressum",
    "privacy_url": "https://acme.example/datenschutz",
    "terms_url": "https://acme.example/agb",
    "legal_info_url": "https://acme.example/informationspflichten",
    "cancel_contract_url": "https://acme.example/vertrag-kuendigen",
    "footer_links_enabled": ["imprint", "privacy", "terms"]
  }'

Besides the raw fields, the response also contains the resolved list footer_links — exactly the links that are actually shown:

{
  "footer_links_enabled": ["imprint", "privacy", "terms"],
  "footer_links": [
    { "key": "imprint", "url": "https://acme.example/impressum" },
    { "key": "privacy", "url": "https://acme.example/datenschutz" },
    { "key": "terms", "url": "https://acme.example/agb" }
  ]
}

Possible errors: 403 (not an administrator). Unknown keys in footer_links_enabled are silently dropped; URLs are limited to 2000 characters (422 if exceeded).

What happens behind the scenes?

Two conditions for display. A link appears only if its key is enabled and a URL can be resolved. The order is fixed (Imprint → Privacy → Terms → Consumer information → Cancel contract).
Three-tier URL resolution. Each URL follows this precedence: value from the instance settings → server environment variable (FOOTER_*_URL) → default path based on the configured LEGAL_BASE_URL (e.g., …/impressum.html). Empty fields thus “inherit” from the server setup where applicable — handy for preconfigured installations.
In e-mails too. The same resolved links form the footer of every system e-mail (password reset, invitation) — in the recipient’s language (DE/EN).
Publicly visible. Like all branding, the links are served without authentication so the login page can display them.
GDPR practice. For a publicly reachable login in Germany, at least Imprint and Privacy should be enabled — Notory only shows them once you configure them.

Customize colors & the logo
Create a user — e-mails with legal links in the footer