Skip to main content
Skip table of contents

Generate keys: Add definition macros in bulk

When to use it?

  • When creating a new requirement document,

  • When you want to ensure that requirement keys are unique.


  • You can insert individual keys by typing /req on a page and selecting the Requirement Yogi macro. See the tutorial.

Using the key generation

On the transformation wizard page, complete the default steps as usual, select a saved transformation or press skip to access the transformation summary.

Like with the Keys transformation or the Links transformation, you can select the tables where you want to apply the key generation.

Your tables are labeled with a number to facilitate table selection

Configuring the key generation

You can use variables to reuse the key generation in other documents.

Available variables :

  • {space.key}

  • {}

  • {page.title.capitals} will use the page title. Exemple: Business Requirements → BR

  • {} will use the parent page title.

You can also type the first requirement name in a table and let the plugin generate a key pattern from that.

We verify every key to ensure their unicity

Changing the plugin configuration

At the summary step before transforming the page, simply click on the rule you want to modify to edit it.

On this step, you can modify every configuration you previously applied, or remove it.

You can add several rules of the same type.

Exemple: Generate keys starting with "BR-" in tables 1 to 3, and keys starting with "FN-" in table 5

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.