# Widget macros

{% hint style="success" %}
**Access Type**: Widgets - Editor
{% endhint %}

Macros are variables that your organization can insert into text components of widgets. Once inserted into a text component, the macro will automatically retrieve the appropriate information for the macro and insert it into the text. In this article we will cover:

* [Widget macro glossary](#widget-macro-glossary)
* [Insert macro into widget text](#insert-macro-into-widget-text)

{% hint style="info" %}
Macros are identified by the use of curly brackets {}, for example: {numberofPartners}.
{% endhint %}

***

### Widget macro glossary

The following macros are currently available by default and can be inserted into text components:

<table><thead><tr><th width="247">Macro</th><th>Description</th></tr></thead><tbody><tr><td>{privacyPolicyURL}</td><td>Inserts the privacy policy URL configured for the brand used in the consent flow</td></tr><tr><td>{websiteName}</td><td>Inserts the company name configured for the brand used in the consent flow</td></tr><tr><td>{numberOfPartners}</td><td>Inserts the total number of vendors added to the consent flow</td></tr><tr><td>{numberOfIABPartners}</td><td>Inserts the total number of IAB vendors added to the consent flow</td></tr><tr><td>{numberofNonIABPartners}</td><td>Inserts the total number of non-IAB vendors added to the consent flow</td></tr></tbody></table>

### Insert macro into widget text

To insert a macro, click **Widgets** on the left-hand panel and select the **Edit** icon inline with a widget name.

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2FVl9fnpSzpTNYbK0LRSRW%2FScreenshot%202026-02-18%20at%2010.08.07%E2%80%AFAM.png?alt=media&#x26;token=29ebf0d6-3354-46e7-a1d8-057d9db45da0" alt="" width="563"><figcaption></figcaption></figure>

Add a text component to the widget or select an existing text component in the widget in the preview window.

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2FhBNXk4UR40U9PFdFknYP%2FScreenshot%202026-02-18%20at%2010.11.27%E2%80%AFAM.png?alt=media&#x26;token=c01c2c7a-9da7-470a-937b-5aae22fb689e" alt="" width="563"><figcaption></figcaption></figure>

With the text component selected in the preview window, ensure the **Settings** tab is selected in the right-hand panel and expand the **Content** accordion. &#x20;

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2F67yOwwVHZlAoBEWfH7ki%2FScreenshot%202026-02-18%20at%203.21.25%E2%80%AFPM.png?alt=media&#x26;token=5b309aa8-3f33-47f0-96d5-3f42ab55e86a" alt="" width="563"><figcaption></figcaption></figure>

Position the cursor in the text field where the macro should be added and click the **{}** icon in the toolbar.

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2FFDTOFbS8GzUJyI3iI7yZ%2FScreenshot%202026-02-18%20at%203.27.09%E2%80%AFPM.png?alt=media&#x26;token=e2255711-8420-4780-a897-028ac5059e6c" alt="" width="286"><figcaption></figcaption></figure>

Select a macro from the drop-down menu.

<figure><img src="https://1825037175-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNDxbAdc00ce6bH5u1urh%2Fuploads%2F4jcKsIDWp684hPfxrZgF%2FScreenshot%202026-02-19%20at%207.59.00%E2%80%AFAM.png?alt=media&#x26;token=b6254585-a317-4dbd-affd-2ff4fcb573bf" alt="" width="297"><figcaption></figcaption></figure>

The selected macro will be inserted the text component. Click **Save** to confirm the edit.