Placeholders
Dynamic placeholders and conditional logic for personalized email signatures.
Personalization & Logic
For a single template to work for the entire company, we use dynamic placeholders and conditional logic.
Inserting Placeholders
Click the { } Placeholders button on the right side of the editor. Here you will find all available variables from two sources:
1. User Data (user.*)
This data comes live from your directory service (Microsoft Entra ID / Azure AD or LDAP). The fields must be maintained in your directory and the integration with Conbool must be set up.
| Placeholder | Description | Example Value |
|---|---|---|
{user.display_name} | Full display name | John Smith |
{user.given_name} | First name | John |
{user.surname} | Last name | Smith |
{user.job_title} | Job title / position | Head of IT Security |
{user.department} | Department | IT Security |
{user.office} | Office / location | Hamburg, Room 4.12 |
{user.street} | Street address | 123 Main Street |
{user.postal_code} | Postal / ZIP code | 20095 |
{user.city} | City | Hamburg |
{user.state} | State / province | Hamburg |
{user.country} | Country | Germany |
{user.phone} | Office phone | +49 40 123456-0 |
{user.mobile} | Mobile number | +49 170 1234567 |
{user.fax} | Fax number | +49 40 123456-99 |
{user.email} | Email address | john.smith@company.com |
{user.photo_url} | Profile photo URL | https://... |
2. Company Data (account.*)
This data is static and is configured under Disclaimer > Settings in Conbool. If your address changes, update it once centrally — all templates update automatically.
Contact Information:
| Placeholder | Description | Example Value |
|---|---|---|
{account.company_name} | Company name | Conbool GmbH |
{account.brand} | Brand name | Conbool |
{account.street} | Street address | 123 Main Street |
{account.postal_code} | Postal / ZIP code | 20095 |
{account.city} | City | Hamburg |
{account.state} | State / province | Hamburg |
{account.country} | Country | Germany |
{account.phone_main} | Main phone number | +49 40 123456-0 |
{account.email_main} | Main email address | info@company.com |
{account.website_url} | Website | https://www.company.com |
Legal Information:
| Placeholder | Description | Example Value |
|---|---|---|
{account.register} | Company register | HRB 12345, Hamburg |
{account.ust_id} | VAT ID | DE123456789 |
{account.representatives} | Managing directors | John Smith, Jane Doe |
{account.supervising_authority} | Supervisory authority | (if applicable) |
{account.legal_footer} | Legal footer text | Registered office: Hamburg |
3. Custom Placeholders (custom.*)
You can define your own key-value placeholders under Disclaimer > Settings. These are available as {custom.key}.
Example: You create slogan = Secure emails. Simple. — in the template use {custom.slogan}.
4. Embedding Images (asset:)
The asset placeholder lets you embed images (e.g., company logo, campaign banners) directly into the signature.
Syntax: {asset:path/to/image.png} or with dimensions {asset:path/to/image.png|w=150|h=50}
| Parameter | Description | Example |
|---|---|---|
w | Width in pixels | w=150 |
h | Height in pixels | h=50 |
Example: {asset:logos/company-logo.png|w=200} displays the logo at 200px width.
The Empty Tag ({ET}) - Hiding Empty Fields
This is one of the most important functions for professional signatures. Often, data is missing for certain employees (e.g., not everyone has an extension or mobile number).
The Problem: If you simply write Mobile: {user.mobile}, the word "Mobile: " remains when the number is missing. This looks unprofessional.
The Solution: Use the Empty Tag ({ET}). Everything between {ET} and {/ET} is completely removed if the placeholder contained within it has no value.
Usage Example
You want to format the mobile number but only display it if it exists:
Input in the Editor: {ET}Mobile: {user.mobile}{/ET}
Result for the Recipient:
- Employee has a number: "Mobile: +49 170 123456"
- Employee has NO number: (The line is completely hidden, no gap).