Signatures deprecated

Signatures

Mail signatures support raw signature templates, predefined signatures, and compose-time placeholders.

Placeholders are rendered only when a signature is inserted in compose. In settings, the raw template stays visible and editable.

Placeholder Syntax

Basic placeholder:

Placeholder with explicit format:

Supported formats:

Format	Result
`text`	Escaped text output. This is the default.
`link`	HTML link, adds `https://` if no protocol is present.
`image`	HTML image tag.
`mailto`	Mail link.
`tel`	Telephone link.

Supported Fields

The following placeholders are supported directly from user profile data:

Names

Placeholder	Source
``	`first_name`
``	`second_name`
``	`last_name`
``	Derived full name
``	`suffix`
``	`title`

Company / Job

Placeholder	Source	Default format
``	`position`	`text`
``	`department`	`text`
``	`room_number`	`text`
``	`room_number`	`text`
``	`company`	`text`
``	`url`	`link`

Communication

Placeholder	Source	Default format
``	`email1`	`mailto`
``	`email1`	`mailto`
``	`cellular_telephone1`	`tel`
``	`cellular_telephone1`	`tel`
``	`telephone_home1`	`tel`
``	`telephone_business1`	`tel`
``	`fax_business`	`tel`

Home Address

Placeholder	Source
``	`street_home`
``	`postal_code_home`
``	`postal_code_home`
``	`city_home`
``	`state_home`
``	`country_home`

Work Address

Placeholder	Source
``	`street_business`
``	`postal_code_business`
``	`postal_code_business`
``	`city_business`
``	`state_business`
``	`country_business`

Configured Placeholder Data

Additional placeholder values can be configured under:

io.ox/mail/signatures/data/**

These values are useful for company-wide data that should not come from the user profile, for example website, logo, hotline, legal text, or campaign links.

Examples:

io.ox/mail:
  signatures:
    data:
      company:
        website: portal.example.test
        email: info@example.test
        phone: +49 123 456789
        logo: https://example.test/logo.png
      legal:
        disclaimer: Confidential. Internal use only.
      campaign:
        spring:
          url: https://example.test/spring

This can be used in signatures like:

<p></p>
<p></p>
<p></p>
<p></p>
<p></p>
<p><img data-src=""></p>
<p></p>
<p></p>

Notes: - company.website, company.email, company.phone, and company.logo have built-in default formats. - Other configured keys under company.*, campaign.*, or legal.* default to plain text unless a format is given explicitly. - Unknown placeholders remain unchanged so missing values stay visible.

Predefined Signatures

Administrators can define predefined signatures under:

io.ox/mail/signatures/predefined

Example:

io.ox/mail:
  signatures:
    predefined:
      company_default:
        title: Company default
        content: |
          <p></p>
          <p></p>
          <p></p>
        insertion: below

Behavior: - predefined signatures appear in the user’s signature list - predefined signatures can also be assigned as defaults - predefined signatures are marked as predefined in settings - predefined signatures are read-only for end users

Notes

Placeholder rendering happens in compose only.
Settings preview and settings editor intentionally show the raw template.