Note: You are viewing Freshservice documentation. For Freshservice for MSPs, visit the MSP Support Portal.
Here's the extensive list of dynamic placeholders you could use for automations, canned responses, email notifications, and so on.
- Tickets Placeholders
- Comment Placeholders
- Approval Placeholders
- Service Desk Placeholders
- Password Reset Placeholders (Applicable only in case of password reset email notification context)
- User Activation Placeholders (Applicable only in case of activation email notification context)
- Catalog Items' Placeholders
- Task Placeholders
Tickets Placeholders
Placeholder name | Placeholder Usage | Return Value |
subject | {{ticket.subject}} | Returns subject of the ticket |
id | {{ticket.id}} | Returns human display id of ticket (Ex: INC-2, SR-3) |
raw_id | {{ticket.raw_id}} | Returns id of the ticket (Note: DB id) |
from_email | {{ticket.from_email}} | Returns the actual email of the requester with which the ticket was raised. Especially used in case of multiple user emails |
description | {{ticket.description}} | Renders description_html with attachments urls |
description_text | {{ticket.description_text}} | Returns text description |
requester | {{ticket.requester}} | Returns requester object. Ex: {{ticket.requester.name}}, {{ticket.requester.email}} etc. Requester attributes can be accessed |
agent | {{ticket.agent}} | Returns agent object. Ex: {{ticket.agent.name}}, {{ticket.agent.email}} etc. Agent attributes can be accessed |
status | {{ticket.status}} | Returns translated status name |
requester_status_name | {{ticket.requester_status_name}} | Returns translated status name configured for requester |
priority | {{ticket.priority}} | Returns translated priority name |
source | {{ticket.source}} | Returns translated source name |
| group | {{ticket.group.name}} | Returns associated group name |
| ticket_type | {{ticket.ticket_type}} | Returns type of ticket |
source_name | {{ticket.source_name}} | Returns translated source name |
tags | {{ticket.tags}} | Returns all associated tag names separated by comma |
due_by_time | {{ticket.due_by_time}} | Returns due by time in current user’s timezone |
due_by_hrs | {{ticket.due_by_hrs}} | Returns due by time (say 1:30 PM) in current user’s timezone |
url | {{ticket.url}} | Returns full ticket url with protocol |
public_url | {{ticket.public_url}} | Returns public ticket url |
portal_url | {{ticket.portal_url}} | Returns support ticket url with protocol and with portal domain |
portal_name | {{ticket.portal_name}} | Returns current portal name |
latest_public_comment | {{ticket.latest_public_comment}} | Returns last public comment with attachment urls if any |
satisfaction_survey | {{ticket.satisfaction_survey}} | Returns survey link for this ticket |
created_on | {{ticket.created_on}} | Returns ticket created at time |
modified_on | {{ticket.modified_on}} | Returns ticket updated at time |
Custom Fields | Returns all custom field values for this ticket | |
status_id | {{ticket.status_id}} | Returns the numerical value of the ticket status |
category_def | {{ticket.category_def}} | Returns category value of the ticket |
sub_category_def | {{ticket.sub_category_def}} | Returns sub category value of the ticket |
item_category_def | {{ticket.item_category_def}} | Returns item category value of the ticket |
original_id | {{ticket.original_id}} | Returns display id of the ticket |
department | {{ticket.department}} | Returns associated department name |
service_request_cost | {{ticket.service_request_cost}} | Returns summation of requested items cost with currency symbol if service request |
service_requested_for | {{ticket.service_requested_for}} | Returns requested for user details if service request |
service_request_item_names | {{ticket.service_request_item_names}} | Returns comma separated names of all requested items if service request |
request_summary | {{ticket.request_summary}} | Returns html view of the requested items |
urgency | {{ticket.urgency}} | Returns urgency value |
impact | {{ticket.impact}} | Returns impact value |
service_item_fields | {{ticket.service_item_fields}} | Returns html table content of the requested item details with fields |
visible_service_item_fields | {{ticket.visible_service_item_fields}} | Returns html table content of the requested visible item details with fields |
Comment Placeholders
Placeholder name | Placeholder Usage | Return Value |
Comment body | {{comment.body}} | Body of the comment added to the ticket |
Commenter | {{comment.commenter}} | Returns the object of user who commented. Ex: {{comment.commenter.name}}, {{comment.commenter.email}} etc. User attributes can be accessed |
Approval Placeholders
Placeholder name | Placeholder Usage | Return Value |
Approval portal url | {{approval.portal_url}} | Returns portal specific approval url with protocol and with portal domain |
Approval url | {{approval.url}} | Returns approval url |
| Approval agent | {{approval.agent}} | Returns agent object. Ex: {{approval.agent.name}}, {{approval.agent.email}} etc. Agent attributes can be accessed |
Service Desk Placeholders
Placeholder name | Placeholder Usage | Return Value |
Service Desk name | {{helpdesk_name}} | Returns name of your helpdesk |
| Include attachments | {{include_attachments}} | Includes attachments of the ticket/article if any |
| Portal name | {{portal_name}} | Returns name of your specific portal (portal_name and helpdesk_name would be same if you have only one portal) |
Password Reset Placeholders (Applicable only in case of password reset email notification context)
Placeholder name | Placeholder Usage | Return Value |
Agent name | {{agent.name}} | Returns name of the agent |
Requester name | {{contact.name}} | Returns name of the requester/contact |
| Password Reset Url | {{password_reset_url}} | Returns the password reset url of the user |
User Activation Placeholders (Applicable only in case of activation email notification context)
Placeholder name | Placeholder Usage | Return Value |
Agent name | {{agent.name}} | Returns name of the agent |
Requester name | {{contact.name}} | Returns name of the requester/contact |
| Activation Url | {{activation_url}} | Returns the activation url of the user |
Problem Placeholders
Placeholder name | Placeholder Usage | Return Value |
Problem ID | {{problem.id}} | Human readable id of the problem |
Subject | {{problem.subject}} | Subject of the problem |
Description | {{problem.description}} | Description of the problem |
Problem URL | {{problem.url}} | Url Of the problem |
Problem Department | {{problem.department}} | Department of the problem |
Problem Agent Name | {{problem.agent.name}} | Agent of the problem |
Requester Email | {{problem.requester.email}} | Email of the requester |
Requester Name | {{problem.requester.name}} | Name of the requester |
Due By | {{problem.dueby}} | Due by of the problem |
Priority | {{problem.priority}} | Priority of the problem |
Impact | {{problem.impact}} | Impact of the problem |
Status | {{problem.status}} | Status of the problem |
Category | {{problem.category_def}} | Category of the problem |
Sub-Category | {{problem.sub_category_def}} | Sub-category of the problem |
Item | {{problem.item_category_def}} | Item of the problem |
Change Placeholders
Placeholder Name | Usage | Value |
|---|---|---|
Change ID | {{change.id}} | Human display Id of the change |
Subject | {{change.subject} | Change Subject |
Description | {{change.description}} | Change Description |
Change URL | {{change.url}} | Full URL path to Change |
Status | {{change.status}} | Change Status |
Impact | {{change.impact}} | Change Impact |
Priority | {{change.priority}} | Change Priority |
risk | {{change.risk}} | |
Change type | {{change.type}} | |
Requester Name | {{change.requester.name}} | |
Requester Email | {{change.requester.email}} | Requester's Email |
Change Agent Name | {{change.agent.name}} | Change's Agent Name |
CAB selected members | {{cab_selected_members}} | List of selected approvers |
Approval Agent Name | {{approval.agent}} | Approval Agent Name |
Planned Start Date | {{change.planned_start_date}} | Change planned start date |
Planned End Date | {{change.planned_end_date}} | Change planned end date |
Change Company/Department | {{change.department}} | Change's Company/Department |
Category | {{change.category_def}} | Change Category |
Sub-Category | {{change.sub_category_def}} | Change Sub-Category |
Item | {{change.item_category_def}} | Change Item |
Helpdesk/Portal name | {{helpdesk_name}} | Your main service desk portal name |
Release Placeholders
Placeholder Name | Usage | Value |
|---|---|---|
Release ID | {{release.id}} | Human readable release id |
Subject | {{release.subject}} | Release Subject |
Description | {{release.description}} | Release Description |
Release URL | {{release.url}} | Full URL path to Release |
Status | {{release.status}} | Release Status |
Type | {{release.type}} | Release's Type |
Priority | {{release.priority}} | Release's Priority |
Requester Name | Name of the requester who raised the Release | |
Requester Email | {{release.requester.email}} | Requester Email |
| Release Department | {{release.department}} | Release Department |
Release Agent Name | Release's Agent Name | |
Planned Start Date | {{release.planned_start_date}} | Release planned start date |
Planned End Date | {{release.planned_end_date}} | Release planned end date |
Category | {{release.category_def}} | Release Category |
Sub-Category | {{release.sub_category_def}} | Release Sub-Category |
| Item | {{release.item_category_def}} | Release Item |
Helpdesk/Portal name | {{helpdesk_name}} | Your main service desk portal name |
Catalog Items' Placeholders
Placeholder name | Placeholder Usage | Return Value |
Requester Name | {{requestor.name}} | Returns name of the requester |
Requester first Name | {{requestor.firstname}} | Returns first name of the requester |
| Requester last Name | {{requestor.lastname}} | Returns last name of the requester |
| Requested for | {{requested_for}} | Returns the name of the person to whom this item is requested |
| Item Name | {{item.name}} | Returns catalog item's name |
| Item Category | {{item.category_name}} | Returns category name to which this item belongs to |
| <Custom Field Name> | {{custom_field.<column_name>}} | Returns the corresponding custom fields value (Placeholder name is dynamic. It is the actual name of custom field). |
Task Placeholders
Placeholder name | Placeholder Usage | Return Value |
|---|---|---|
Task ID | {{task.id}} | Returns the ID of the task |
Task Title | {{task.title}} | Returns the title of the task |
Task Description | {{task.description}} | Returns the description of the task |
Task Start Date | {{task.start_date}} | Returns the start date of the task |
Task Due date | {{task.due_date}} | Returns the due date of the task |
Task Creator Name | {{task.user.name}} | Returns the name of the user who created the task |
Task Owner Name | {{task.agent.name}} | Returns the agent name of the task |
Task Group Name | {{task.group.name}} | Returns the name of the group in which the agent associated |
Task URL | {{task.url}} | Returns the URL of the entity to which the task is associated with. For example, for a task associated with a ticket, the ticket URL will be appended to placeholder. |
Task Status | {{task.status}} | Returns the status of the task |
| Parent ID | {{taskable.id}} | Returns the ID of the parent entity in which the task is associated |
| Parent Subject | {{taskable.subject}} | Returns the subject of the parent entity in which task is associated |
| Parent Description | {{taskable.description}} | Returns the description of the parent entity in which task is associated |
| Service Desk Name | {{helpdesk_name}} | Main portal name |
Asset Label Printer Settings Placeholders (Little different from Asset Placeholders)
Placeholder name | Placeholder Usage | Return Value |
|---|---|---|
| Asset Display Name | {{asset.display_name}} | Name of the asset |
| Asset Tag | {{asset.asset_tag}} | Tag value of the asset |
| Used By | {{asset.used_by}} | Name of a contact who uses the asset |
| Managed By | {{asset.managed_by}} | Name of an agent who uses the asset |
| Company | {{asset.company}} | Name of the Company/Department of the asset |
| Location | {{asset.location}} | Name of the location of the asset |
| Serial Number | {{asset.serial_number}} | Serial number of the asset (Only if the asset is an Hardware or its children) |
| IP Address | {{asset.ip_address}} | IP Address value of the asset (Only if the asset is an Hardware or its children) |
Contract Placeholders
Placeholder name | Placeholder Usage | Return Value |
|---|---|---|
Contract Number | {{contract.contract_id}} | Returns the ID of the contract |
| Contract Name | {{contract.name}} | Returns the Name of the contract |
| Contract Description | {{contract.description}} | Returns the Description of the contract |
| Contract Start Date | {{contract.start_date}} | Returns the Start date of the current contract |
| Contract End Date | {{contract.end_date}} | Returns the End date of the current contract |
| Contract Requester | {{contract.requester.name}} | Returns the requester/creator of the contract |
| Contract URL | {{contract.url}} | Returns the URL to access the contract's details |
| Renewal Type | {{contract.renewal_type}} | Returns the Renewal type of the contract |
Project Placeholders
Placeholder name | Placeholder Usage | Return Value |
|---|---|---|
--Not exposed in placeholder section-- | {{project.id}} | Display Id of the Project |
| Project Title | {{project.title}} | Title of the Project |
| Project Description | {{project.description}} | Description of the Project |
| Project Status | {{project.status}} | Current Status of the Project |
| Project Priority | {{project.priority}} | Priority of the Project |
| Project Requester | {{project.user.name}} | Name of the user who created the Project |
| Project Owner Name | {{project.owner.name}} | Owner name of the Project |
| Project URL | {{project.url}} | Url of the Project |
| Project Start Date | {{project.start_date}} | Start date of the Project |
| Project End Date | {{project.end_date}} | End date of the Project |
Project Task Placeholders
Placeholder name | Placeholder Usage | Return Value |
|---|---|---|
| Task ID | {{task.id}} | Human Display Id of the Task |
Task Name | {{task.name}} | Will be deprecated |
| Task Title | {{task.title}} | Title of the Task |
| Task Description | {{task.description}} | Description of the Task |
| Task URL | {{task.url}} | Url of the Project |
| Parent ID | {{taskable.id}} | Human Display Id of the Project |
| Parent Subject | {{taskable.subject}} | Title of the Project |
| Parent Description | {{taskable.description}} | Description of the Project |
| Task start date | {{task.start_date}} | Start date of the Task |
| Task due date | {{task.due_date}} | Due date of the Task |
| Task Creator name | {{task.user.name}} | Name of the user who created the Task |
| Task Owner name | {{task.agent.name}} | Owner name of the Task |
| Task Status | {{task.status}} | Status of the Task |
| --Not exposed in placeholder section-- | {{task.dependency}} | Type of the dependency [successor/predecessor] with the current task(applicable for dependency notification) |
| --Not exposed in placeholder section-- | {{task.dependency_title}} | Title of the dependent task(applicable for dependency notification) |
| --Not exposed in placeholder section-- | {{current_user_name}} | Name of the user who performed the action(applicable for task comment and watcher notification) |
