User Guide Cancel

Create and use variables for easy updates

  1. RoboHelp User Guide
  2. Introduction
    1. Get to know RoboHelp workspace
    2. What's new in RoboHelp 2022 release
      1. What's new in Update 5
      2. What's new in Update 4
      3. What's new in Update 3
      4. What's new in Update 2
      5. What's new in Update 1
    3. Fixed Issues in RoboHelp
    4. RoboHelp System Requirements
    5. Download RoboHelp on Windows and macOS
    6. Download and install Adobe app
    7. RoboHelp FAQs
    8. What's new in RoboHelp 2020 release
      1. What's new in Update 8
      2. What's new in Update 7
      3. What's new in Update 6
      4. What's new in Update 5
      5. What's new in Update 4
      6. What's new in Update 3
      7. What's new in Update 2
      8. What's new in Update 1
  3. Projects
    1. Plan your RoboHelp project
    2. Create a project
    3. Manage projects
    4. Work with topics and folders
    5. Generate reports
    6. Work with context-sensitive help
    7. Manage References
    8. Set preferences in RoboHelp
  4. Collaborate with authors
    1. Collaborate using Git
    2. Collaborate using SharePoint Online
    3. Collaborate using Azure DevOps (Team Foundation Server)
  5. PDF Layout
    1. PDF templates
    2. Design a page layout
    3. Publish PDF output
    4. Work with the common content styles
    5. Components of a PDF template
    6. Support for language variables
    7. Customize PDFs
  6. Editing and formatting
    1. Format your content
    2. Create and manage cross-references
    3. Create and manage links
    4. Single-source with snippets
    5. Work with images and multimedia
    6. Create and use variables for easy updates
    7. Work with Variable Sets
    8. Use Find and Replace
    9. Auto save your content
    10. Side-by-side editing in Split View
    11. Use the Spell Check feature
    12. Create and Edit Bookmarks
    13. Insert and update fields
    14. Switch between multiple views
    15. Autonumbering in CSS
  7. Import and linking
    1. Import Markdown files into a project
    2. Import Word documents into a project
    3. Import FrameMaker documents into a project
  8. TOCs, indexes, glossaries, and citations
    1. Create and manage a Table of Contents
    2. Create and manage an index
    3. Create and manage a glossary
    4. Create and manage citations
    5. Create and manage browse sequences
    6. Work with See Also and Related Topics
  9. Conditional content
    1. What is conditional content
    2. Create and apply condition tags
    3. Configure output presets for conditional content
    4. Optimize and manage conditional content
  10. Microcontent
    1. Microcontent
  11. Review and Collaboration
    1. Review and Collaboration
  12. Translation
    1. Translating content to multiple languages
    2. Configure a translation framework for a service provider
  13. Generating output
    1. Generate output
    2. Generate Frameless output
    3. Generate Knowledge Base output
    4. Generate PDF output
    5. Generate Responsive HTML5 output
    6. Generate Word Document output
    7. Generate Content Only output
    8. Generate eBook output
    9. Generate Microsoft HTML Help output
    10. Generate Mobile App output
  14. Publish output
    1. Publish to a RoboHelp Server
    2. Publish to an FTP server, a Secure FTP server, or a File System
    3. Publish to SharePoint Online
    4. Publish to Zendesk Help Center
    5. Publish to Salesforce Knowledge Base
    6. Publish to ServiceNow Knowledge Base
    7. Publish to Zoho Knowledge Base
    8. Publish to Adobe Experience Manager
    9. Publish to Atlassian Confluence Knowledge Base
  15. Appendix
    1. Adobe RoboHelp Scripting Reference
    2. RoboHelp keyboard shortcuts

Learn how to create, edit, and manage a variable, and insert a variable in a topic in RoboHelp.

A variable is a text phrase or word that serves as a reusable piece of information, simultaneously used across multiple topics in your project. This makes your content portable and easy to update. When you modify a variable or its value, every occurrence of that variable or value is updated across the project.

Create a variable

A variable is a text phrase to which you assign a value. Follow these steps to create a variable in your open project:

  1. In the Author tab, select Variables. The Variables panel opens.

  2. In the Variables panel, select     to open the Variables editor.

  3. Enter the variable name in the Name column and its value in the Value column.

  4. Select         to add a new variable. 
    You can add multiple variables by repeating the process and then select Save. The variables get added to the list in the Variables panel.

    create variable

Note:

The variable created does not get removed by Undo (Ctrl + Z).

Edit a variable

To edit a variable in RoboHelp, follow these steps:

  1. In the Author toolbar, select Variables. The Variables panel opens.

  2. In the Variables panel, select  next to the desired variable.

  3. Select Edit in the given Options list.

  4. In the Edit variable dialog box, you can edit the Name and Value of the selected variable.

  5. Click Done.

Note:

If you rename any variable, RoboHelp simultaneously updates all the references wherever applicable. For example, Topic titles, Topic content, Table of Contents, Output Presets titles, Variable Sets, and so on.

Insert a variable

To insert or use a variable in an open topic:

  1. To open a topic:

    In the Author toolbar, select Contents and open a topic of your choice from the Contents panel.

  2. Select Variables in the Author toolbar. The Variables panel opens.

  3. Select a variable from the Variables panel. Now drag-and-drop the selected variable at the desired text location in the open topic.

    Alternatively, press Ctrl+1. From the Variable dialog box, you can search through the list of variables and select a variable to insert it.

  4. Click the Save All icon  at the left side of the standard toolbar.

Convert text to variables

An alternative way to add a variable is to select a portion of a text and then add the selection as a value. For example, if you have a product that has a lengthy name and you want to reuse the name in multiple places, you can highlight the product and add it as a value.

This workflow also serves as a shortcut in creating a variable.

This is how you'd add a selection to a variable:

  1. In a topic, select the text that you want to add as variable.
  2. Right-click the selection.
  3. In the context menu, click Add to Variable.
  4. In the Define variable dialog, specify the variable that must be mapped to the selection.

The gif below demonstrates this workflow.

Duplicate a variable

  1. In the Variables editor, select    next to the variable you want to duplicate.

  2. Select Duplicate from the list to open the Duplicate Variable dialog box.

  3. Edit the Name of the duplicate variable.

  4. Select Done.

  5. Select Save, to display the duplicate variable in the variables list in Variables panel.

    duplicate a variable

Delete a variable

  1. In the Author toolbar, click Variables. The Variables panel opens.

  2. Select  option next to the desired variable either in the Variables panel or in the Variables editor.

  3. Select Delete in the Options list.

  4. Click Yes in the Confirm dialog box to delete the selected variable.

    Note:

    Clicking on Save is not required.

  5. If the variable is referenced in your project, you are prompted to choose among the listed three options:

    • Delete the variable and its references - Deletes the variable and all its occurrences in the project.
    • Delete only the variable - Deletes only the variable. This retains the references of the variable in the project.
    • Delete variable and replace references with actual content - Deletes the variable and replaces all its occurrences with the variable value.
  6. Select the relevant option and click Done.

Generate Variables report

You can generate a Variables report to view and manage variables in your project. Using this report you can find variables that are used in a topic and those that are not used in any topic. Before you delete a variable, you can locate the topics in which the variable is used and delete references to that variable.

You can then download or print the Variables report.

  1. In the Author toolbar, select Reports. The Reports panel opens.

  2. In the Reports panel, select Variables.

  3. Use the Filters panel on the right side of the screen to customize the report. To know more, see Customize a report.

  4. Once you've customized the Variables report based on your needs, click the Download icon  in the standard toolbar to instantly download the report. The report is saved as a .csv file.

  5. To print the report, click the Print icon  in the standard toolbar.

Search and preview a variable

You can search for a variable by entering the variable's name in the search bar in Variables panel. Select    option next to the variable in the Variables panel or in the Variables editor to preview the value of a variable. 

The preview of the value displays.

preview variables

The gif below demonstrates the search and preview workflow.

 Adobe

Get help faster and easier

New user?