Skip to main content
A site is a domain you publish on. A fragment is one card slot on a site. Your edge never names a fragment: doubleshift resolves each page URL to one fragment of its site (resolution). You set up both in the console, under Sites & fragments.

​
Register a site

Add the bare domain, host only. Protocol, path and port are stripped, so https://your-domain.example/news becomes your-domain.example.
  • Domain: required, unique within your account. Register one form: a page on its www. or bare alias finds it too.
  • Display name: optional, a label for the console.
Deleting a site deletes its fragments and routing rules.

​
Create a fragment

Two puzzle pieces of the same shape, slightly offset. On the left, the fragment: an empty outline, called from your edge, low latency and never cached, carrying the page context. On the right, the card: the filled piece that completes it, structured brand data, sourced copy, placed before the article.Two puzzle pieces of the same shape, slightly offset. On the left, the fragment: an empty outline, called from your edge, low latency and never cached, carrying the page context. On the right, the card: the filled piece that completes it, structured brand data, sourced copy, placed before the article.

A fragment is the slot; the card is the piece that completes it.

Open the site, fill in New fragment, then Create fragment. For a publisher group under one GAM network, this means one account, one site per domain and one fragment per level-3 family. The reference carries the site segment (news-site above), so it only needs to be unique per site. Create one fragment per section that needs its own card eligibility, then route that section’s paths to it.

​
Pause or delete a fragment

A fragment is active or paused: Pause and Activate switch it from the fragment list. Pages resolved to a paused fragment answer no-fill (204), with no fallback to another rule or the default, and render without a card. Pausing keeps the default and the rules that point to the fragment; the console then tells you which of them will answer 204. The change applies on the next call (no cache). Delete removes the fragment, the routing rules that target it, its place as site default and its place in every card’s eligibility.
A card whose eligibility listed only deleted fragments is left with an empty list, so it becomes eligible everywhere in your account. Check your cards’ eligibility before you delete a fragment or a site.

​
Default fragment and routing rules

Open the site to decide which fragment each page gets. An exact rule wins, then the longest prefix, then the default fragment (resolution).
1

Set the default fragment

Under Default fragment, choose an active fragment of the site, then Save default. It serves every page no routing rule matches; choose none to answer 204 on those pages instead. The fragment list marks it with a default badge.
2

Add routing rules

Under Routing rules, enter a Path prefix, choose prefix or exact, select a fragment of the site, then Add rule. A rule may target a paused fragment; a default may not. Delete rule removes one.
Leading and trailing slashes are added for you. A path holds no query string, hash, whitespace, dot segment or repeated slash. Use / with exact for the homepage, or with prefix for every page. Paths are stored in lowercase and percent-encoded like the page path they are compared with. The same path and match appear once per site, and a site holds at most 200 rules. On a fragment’s Integration page, the routing rules you select become the scope of the Worker code (scope). Nothing is saved: a rule added later covers pages outside that scope only once you generate the code again and redeploy.

​
abc.txt, an optional public declaration

Cards are delivered with or without it. If you want to, publish a small text file at the root of your site, at https://<your-domain>/abc.txt, to publicly declare doubleshift as an authorized branded-content provider. It is the same transparency model as ads.txt, applied to the agentic web.
abc.txt
Each line is provider_domain, account_id, relationship:
  • shftd2.com: the doubleshift provider domain (fixed).
  • <your account id>: your account id, shown in Settings → Account (also your partner_id).
  • DIRECT: you control the account directly. RESELLER means a partner resells on your behalf.
The file is text/plain, ASCII; # starts a comment and unknown fields are ignored. See the ABC spec for the full format.