Merge Tags

A merge tag is a small placeholder tag, that may consist of a few words or strings of text, which you can add to any page on your help site. The text you add to the page is not formatted and is stored as plain-text on publishing the page.

Merge tags are flexible and reusable, making it simple to make site-wide changes by editing the merge tag source instead of having to modify many pages, separately.

Types of Tags

There are two kinds of merge tags:

1. System merge tags - These are pre-defined tags that you can re-use to quickly update a page’s content. You cannot alter or edit these tags.

2. Custom merge tags - Custom tags are those tags which you can create as per you requirements and add them to pages on your help site.

Follow these steps to add custom merge tags:

Step 1: On your ProProfs Knowledge Base dashboard, click Add New.

Step 2: Select Merge Tag from the dropdown.

Step 3: Provide the Name, Default Value for the placeholder. Click on Save.

1. Name - Enter the name of the tage which you want to create.

2. Default Value - Enter the default value of your tag. This value will display by deafult if you haven't defined any tag value.

Follow these steps to insert merge tag into a page:

Step 1. Select Merge Tag from the Insert drop down on the editor.

Step 2. Select the System Merge Tag or Custom Merge Tag you want and then click on Insert to add it to the page.

When to use System merge tags

ProProfs Knowledge Base offers a library of different system merge tags that you can use at a click. Here are some scenarios, where you can use system merge tags:

1. User Identification - Use these tags to identify the profile of the author or editor who created or made changes/edits to a particular page on your help site.

Tag Name	Description
user.first_name	Display the first name of the user.
user.last_name	Display the last name of the user.
user.email	Display email address of the user.
user.role	Display the role of the user like admin, editor etc.
user.language	Display the language preference of the user.
user.timezone	Display timezone of the user
user.last_login_time	Display the last login date and time of the user.

2. Page identification - Use these tags to identify the attributes of a page such as its title, id, status, etc.

Tag Name	Description
page.id	Display unique id of the page.
page.type	Display the type of the page like text or video.
page.title	Display the tittle of the page.
page.status	Display status of the page like published, draft etc.
page.toc_name	Display the name of the page on the table of content.
page.url	Display URL of the page.
page.created_at	Display the date and time of the page when the page was created.
page.created_by	Display full name of the user who created the page.
page.last_modified_at	Display date and time of the page when the page was last modified.
page.last_modified_by	Display full name of the user who modified the page last time.
page.published_at	Display date and time of the page when the page was last published.
page.published_by	Display full name of the user who published the page last time.
page.related_articles	Display the related articles on the page.
page.published_till	Display the expiry date of the page.

3. Navigation - Use these tags to add navigation menus to a page such as "Next" or "Previous" link, breadcrumbs, inline to and more.

Tag Name	Description
page.next_page	Display a hyperlink of the next page based on the table of content order.
page.next_page_url	Display URL of the next page based on the table of content order.
page.previous_page	Display a hyperlink of the previous page based on the table of content order.
page.previous_page_url	Display URL of the previous page based on the table of content order.
page.breadcrumb	Display the breadcrumb based on the table of content. Ex - You are here xyz.
page.pages_in_folder	Display all the pages loacted in the folder.
page.folder_name	Display the name of the folder in which the page is located.
page.children_pages	Display all the pages located inside the page as hyperlink.
page.inline_toc	Scan the headings on the current page to create an inline table of content based on those headings
page.embed_page	Display the embede page.

4. Additional information - Use these tags to give additional information about your company, website, recently published pages in your knowledge base and more.

Tag Name	Description
site.name	Display the name of the help site.
site.url	Display the URL of the help site.
site.language	Display the language of the help site.
site.recently_published_pages	Display the most recently published page.
company.name	Display company name.
company.website	Display company website.

Related Articles:

Sync Page
Help Site Branding
Content Snippets