Skip to main content
Skip table of contents

Transformation wizard: Transform your pages

Transform your existing documents

This wizard helps you format documents and insert Requirement Yogi macros in bulk.

When to use it?

  • When you've imported a Word document into Confluence and you need to clean up the formatting for Requirement Yogi,

  • When you are writing requirement pages and you need to assign requirement keys in bulk.

  • When you have a company policy for requirement keys, and you want everyone to apply the same formatting to their documents.

What operations are available?

These simple operations already fit 90% of our observed usecases. If you need other operations, please don't hesitate to submit a support ticket.

How to use the Transformation wizard?

3 ways to access the wizard

1. On your Confluence page, from the page menu:

2. On your Confluence page, click on the byline at the top of the page:

3. From the Pages tab, click "Transform" :

Example for a first transformation

  1. On the left, you'll see a preview of the page you'll be transforming.

  2. On the right, you’ll be able to create a new transformation, or reuse a saved transformation.

  • If you click on Add Transformation, you’ll be able to choose a specific rule mentioned above.

  • If you directly click on Next, we’ll parse your document and guide you to the basic transformations (Generation, or keys and links transformation).

    • Let’s click on Next.

Transformation 1.png
  1. The Transformation Wizard will analyze your table to know which data is supposed to be transformed.

  • Which tables do you want to transform? Which columns? Which transformation rule do you want to apply

In the example, my first column is supposed to be a requirement, so I click on Yes.

Transformation 2.png

  1. Transform written text in the first cell into requirement keys

  • You can use multiple criteria (and even regular expressions), or manually exclude single requirements.

Click here if you need more information on Transforming Keys.

Transformation 3.png

  1. Next comes the dependencies and links. Find more information on the links transformation here.

  • The Transformation Wizard will scan the table cells for text matching requirement macros already created, or that are in the process of being transformed, and convert them to requirement yogi link macros.

Transformation 4.png

  1. In the end, you’ll see a summary of the rules.

  • You can edit them and add more.

  • You can also save this transformation by giving it a name.

Transformation 5.png

And voilà ! Your page is now transformed.

Transformation 6.png

How to reuse a saved transformation

Once a transformation is saved, you can reuse it on another page by accessing the transformation wizard again. It will also help you to apply the transformation in bulk.

🔒 → They indicate a transformation only accessible to some users. By default, all transformations are private, and we'll see how to share them later.

How to transform multiple pages in bulk

If you need to apply a transformation to multiple pages at once. Go to the Pages tab.

  • Select your pages

  • At the bottom, select a saved transformation and click on transform.

💡You can use CQL to search for specific pages.

Transform in bulk - 1.png

Share your transformations

Everyone can share their transformations, and administrators can override them.

  • Go to the Manage tab.

Admins have access to all transformations in the space, while simple users can only manage their own transformations.

  • Click on edit to:

    • Change the name / description

    • Change permissions (view, view and read, view and edit)

Screenshot 2025-04-01 at 11.45.27.png
JavaScript errors detected

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

If this problem persists, please contact our support.