Skip to main content

Add a version indicator to your pages

Written by Miller Saltzman
Documentation Editor, Customer Success at MindTouch
This page applies to:MindTouch Responsive

Want to save your customers and your support agents some time? This document explains how to create a custom template in MindTouch that will tell your customers and support agents to which of your products the article they are viewing applies. Follow the steps outlined in this article to apply a version banner template to your pages.

Why should I use version indicators?

Version indicators can help your customers easily identify the correct documentation for the version they are using and help unsure users figure out which version documentation they should be looking at. Other reasons may include:  

  • Deprecating an old version.
  • Encouraging customers to upgrade to a new product. (This template could show hesitant customers how similar your documentation is across your different products.)
  • Your support agents can easily determine product support.

Create your template

To create a template that will tell you what version of your software your documentation applies to:

  1. Go to Site tools > Dashboard > Content managementTemplates > Template:Custom > Views.
  2. Click New to create a new template under Views.
  3. Choose a title for your template. (You will be using this title later.)

Add DekiScript code
  1. On the editor toolbar click Styles and select DekiScript. 
  2. Paste the following DekiScript code into the DekisScript code box.
var version = $version ?? "default";

<div class="version-indicator">
  <span class="version-text">"This article applies to:"</span>
  if (!version || version == "" || version =="V1")
      <span class="version-tag version-V1">
          <a class="F1 version-reference-link" href="#">"Only Version 1"</a>
  if (version == "V2")
      <span class="version-tag version-V2">
          <a class="F1 version-reference-link" href="#">"Only Version 2"</a>
  if (version == "both")
      <span class="version-tag version-both">
          <a class="F1 version-reference-link" href="#">"Version 1 and Version 2"</a>

Add CSS code
  1. On the editor toolbar click Styles and select CSS. 
  2. Paste the following CSS code into the CSS code box.
  3. Click Save.
.version-indicator {
   border:1px solid #ccc;
.version-indicator span {
.version-indicator .version-text {


Edit your DekiScript code

To edit the code to pertain to your product, replace V1 and V2 in the DekiScript code with versions of your product. To add more versions, paste the following snippet at the end of the code (before the </div> tag!):

if (version == "V3")
<span class="version-tag version-V3">
<a class="F1 version-reference-link" href="#">"Only Version 3"</a>

Link to a document (optional)

To link versions to a document that explains, for example, which version a customer is using, replace the # (of the href attribute) with the path only to that document. The href attribute would look something like this: /Documentation/User_Guide/What_version_of_MindTouch_am_I_using%3F


Add your template to a page

Now that you have created the template, you must add another piece of DekiScript code to your page to surface the version indicator.

  1. Open your page in Edit mode.
  2. Make sure your cursor is at the top of the page. 
  3. On the editor toolbar, click Styles and select DekiScript.
  4. Paste the following code in a DekiScript box:
template("Custom/Views/Template_Title", {version:"V1"});
  1.  Replace Template_Title with the title of your template. Make sure to use an underscore (_) instead of a space.
  2.  Replace V1 with the version to which the document applies. Make sure the name of the version has quotation marks around it. Keep in mind that two quotation marks by themselves ("") refer to "Only Version 1," while "both" refers to "Version 1 and Version 2." 

What's next?

Browse our section on creating templates for further help.  

  • Was this article helpful?