Skip to main content

Getting Your Wrapper Tag

The wrapper tag is a small inline script that initializes header bidding for your domain. Copy it from the portal and install it in the <head> of your site.

What the tag does​

The tag is an inline loader IIFE (not a hosted <script src=…>). Once it runs, it:

  • Loads the wrapper library for your domain from the jsDelivr CDN
  • Fetches your wrapper config (ad slots, layouts, bidders, floors) from the Portal API
  • Initializes header bidding by calling window.Wrapp.bootstrap(config) with the fetched config
  • Registers command queues on window.pbjs and window.googletag for Prebid and GPT

The library is versioned per-domain under a private npm package; jsDelivr serves the CDN. Config changes propagate in seconds without a library rebuild.

Getting the tag​

  1. Open the portal and switch to Account mode (bottom of the main sidebar).
  2. Select the domain you want in the account selector at the top of the sidebar.
  3. Go to Setup → Wrapper.
  4. Use the Copy Tag button to copy the tag to your clipboard, or use the dropdown for:
    • Download Tag — saves the <script> block as an HTML file
    • Download Source — saves the un-minified loader source

The page also has a collapsible Tag Source Code accordion if you want to read the loader before installing it.

You need a domain selected

The tag is domain-specific. If only a customer is selected in the account selector, the page shows "Select a specific domain to view and copy the wrapper tag." — switch the selector to a domain.

What the tag looks like​

A single <script> block containing the inline loader. Inside it, the important values are:

  • Your domain ID (appears in the npm package name and the config URL)
  • The npm org and env domain for your deployment

Don't hand-edit these — copy the tag from the portal so the values match what's provisioned for your account.

Next​

After copying the tag:

Install the tag on your site →

Common questions​

Does the tag URL change?

The tag itself is inline, so there is no URL. The library URL embedded in the loader does change with each release, but the loader resolves it dynamically from jsDelivr — you don't re-copy the tag to pick up new releases.

What if I have multiple domains?

Each domain has its own tag. Switch domains in the account selector at the top of the sidebar, then copy that domain's tag.

Can I self-host the library instead of loading from jsDelivr?

Not at present. The loader is hard-coded to jsDelivr. If this is a blocker for your setup, contact your account manager.