Before you start
- You need edit access to Relay in the company. Read-only users are sent back with "You have read-only access to Relay in this company."
- Sources and mediums are picked from approved-value lists. A Terrain definition with approved values for
utm_sourceand one forutm_mediummust exist, or the pickers show "No vocabulary bound." See Taxonomy. - The campaign must exist and not be archived. Its agreed value becomes
utm_campaignon every link.
Generate links
- Go to Relay > Links and click Bulk generate (also on the Relay dashboard under Create).
- Under Set up, pick the Campaign and the Template, and enter the Destination URL, for example
https://www.example.com/spring-sale. - Optional: enter a Title prefix. Each link is named "prefix - source - medium - content".
- Under Combinations, tick the Sources and Mediums you want. In Content, enter
utm_contentvalues one per line, for examplecarousel_aandstory_a. Content is free text; leave it empty for no content value. - Check the count, for example "12 links from 2 sources x 3 mediums x 2 content values."
- Review the Preview: each row shows the title, source, medium, content and final URL.
- Click Create N links.
Every selected value is crossed with every other. One run creates at most 200 links; narrow the combinations if you need more.
Check it worked
The Result column shows Created or Refused on each row, with the reason for a refusal. A message confirms how many were created. New links are drafts: review them in the link library, then set them active.
Click Export preview as CSV to download the preview (relay-bulk-preview.csv) before or after creating.
Duplicates and refusals
- A row with the same destination, source, medium, campaign and content as an existing link is marked "Already exists - will be skipped" and is not sent.
- Each new link is validated against the template on the server, the same as a single link. A required field the template expects but the builder does not fill, a value off a closed list, or a value over a length cap refuses that row only. The rest are still created.
Troubleshooting
| Symptom | Cause and fix |
|---|---|
| "No vocabulary bound." in Sources or Mediums | No approved-value list exists for that parameter. Create one in Terrain |
| Create stays disabled | Pick a campaign, enter a destination, and tick at least one source and one medium |
| "A single run creates at most 200 links" | Reduce the sources, mediums or content values |
| Rows refused with a template message | The template requires something the builder does not set, or a value breaks a rule. Pick another template or adjust it on Templates |