Skip to main content

Useful Template Variables

in Advanced Content Editing
Authors list
Published: 21 Sept 2021|Last updated: 19 Oct 2021

You may recognize that many variables used in Templates are the same ones you use for snippets in the Agent interface.

Note


You can only include these variables directly in a template, not in a custom phrase. See the section Variables in Custom Phrases for details.

Logged In User Information

The variables in this section will only work in contexts where the User is logged, e.g. on the Help Center or widget, but not Email.

{{ app.user.name }}
copy

User’s name.

{{ app.user.email_address}}
copy

User’s email address.

{{ app.user.organization.name }}
copy

Name of User’s Organization.

{{ app.language.id }}
copy

ID number of User’s language.

Language

{{ lang.id }}
copy

Language ID number.

{{ lang.flag_image }}
copy

Language flag image.

{{ lang.title }}
copy

Language name.

Search Results

{{ res.type }}
copy

Result type.

{{ res.object.id }}
copy

Result ID.

Agent

{{ agent.display_name_user }}
copy

Agent override name displayed to Users (as set in Preferences).

{{ entity.agent.primary_phone.number }}
copy

Agent phone number.

Tickets

{{ ticket.subject }}
copy

Ticket subject.

{{ ticket.department.title }}
copy

Ticket department.

{{ ticket.department.full_title }}
copy

Ticket department full title.

{{ ticket.product.title }}
copy

Current product of Ticket.

{{ ticket.category.title }}
copy

Current category of Ticket.

{{ ticket.workflow.title }}
copy

Current workflow stage of Ticket.

{{ ticket.priority.title }}
copy

Current priority of Ticket.

{{ ticket.id }}
copy

Ticket ID number.

{{ ticket.ref }}
copy

Ticket ref code.

{{ ticket.date_created|date('full') }}
copy

Time and date Ticket was created e.g. “2014-03-14 11:38:17”.

{{ ticket.date_last_agent_reply|date }}
copy

Time and date of the last Agent reply.

{{ ticket.agent.display_name }}
copy

Name of currently assigned Agent (or override name if set).

{{ ticket.email_account.address }}
copy

Address of the Email account/relay the Ticket currently sends mail from (ie. support@example.com)

{{ ticket.person.display_name }}
copy

User’s full name.

{{ ticket.person.first_name }}
copy

User's first name only.

{{ ticket.person.last_name }}
copy

User's last name only.

<dp:ticket-messages />
copy

List of Ticket messages - doesn’t need {{ }} around it.

Custom Fields

{{ ticket.renderCustomField(N) | raw }} OR {{ ticket.renderCustomField (N, 'text') }}
copy

Display a custom ticket field; replace N with field ID (use the gear icon at top right of fields list to display IDs).

{{ ticket.person.renderCustomField(N) | raw }} OR {{ ticket.person.renderCustomField (N, 'text') }}
copy

Display a custom User field; replace N with field ID.

{{ ticket.person.organization.renderCustomField(N) | raw }} OR {{ ticket.person.organization.renderCustomField (N, 'text') }}
copy

Display a custom organization field, replace N with field ID.

Ticket User Information

{{ ticket.person.display_name }}
copy

Name of User associated with Ticket.

{{ ticket.person.primary_email.email }}
copy

Ticket User’s email.

{{ ticket.organization.name }}
copy

Ticket User’s Organization.

{{ ticket.person.organization_position }}
copy

Ticket User’s position in Organization.

Ticket Agent Information

{{ ticket.agent.display_name }}
copy

Name of assigned Agent.

action_performer.display_name
copy

Name of Agent who performed the action, such as adding a response.

{{ ticket.agent.primary_email.email }}
copy

Agent’s primary email.

{{ ticket.agent_team.name }}
copy

Assigned team.

Ticket Form

{{ f.title }}
copy

Title.

{{ f.field_def.description }}
copy

Field description.

Article

{{ article.person.display_name_user }}
copy

Article author.

{{ article.title }}
copy

Article title.

Message

{{ message.person.display_name_user }}
copy

Message author.

News

{{ news.person.display_name_user }}
copy

News post author.

{{ news.category.title }}
copy

News post category.

{{ news.content }}
copy

News post article.

{{ news.link }}
copy

News link.

Download

{{ download.title }}
copy

Title of download file.

{{ download.content_desc }}
copy

Description of file.

{{ download.filename }}
copy

Filename of file.

{{ download.readable_filesize }}
copy

Filesize of file.

{{ download.person.display_name_user }}
copy

Author of download.

{{ download.date_created|date('full') }}
copy

Date created.

Ticket Feedback

{{ feedback.status }}
copy

Feedback item’s status.

{{ feedback.person.display_name_user }}
copy

Feedback creator.

{{ feedback.message }}
copy

Feedback message.

{{ feedback.rating }}
copy

Feedback rating.

Category

{{ category.title }}
copy

Category name.

{{ subcat.title }}
copy

Subcategory name.

Participant

“Participant” means a CC’d User.

{{ part.person.id }}
copy

Participant ID.

{{ part.person.email_address }}
copy

Participant Email address.

Advanced

{{ ticket_object.getLastReply().email_source.header_from }}
copy

"FROM:" Email header contents of the last Email reply (or first Email if this is a new Ticket).

HelpfulUnhelpful
next pageVariables in Custom Phrases
previous pageEditing Help Center Phrases

Please log in or register to submit a comment.