---
title: "One short link, hundreds of QR codes: dynamic slugs capture each table or product from the URL path"
description: "Print hundreds or thousands of QR codes from one short link, one per table, product, serial number or booth. A dynamic slug such as menu/{table} answers every value, saves it on the visitor, and can route on it from the first scan."
canonical: "https://linkbreakers.com/help/article/dynamic-slugs-capture-data-from-the-url-path"
last-updated: 2026-11-06
---

# One short link, hundreds of QR codes: dynamic slugs capture each table or product from the URL path

> Print hundreds or thousands of QR codes from one short link, one per table, product, serial number or booth. A dynamic slug such as menu/{table} answers every value, saves it on the visitor, and can route on it from the first scan.

Video: [Bulk QR codes from one link: a code for every table or serial number](https://www.youtube.com/watch?v=1l_1MNRXoEY)

:::try-ai-prompt {"prompt":"Create a link on my custom domain with the slug menu/{table} that sends visitors to https://yourbrand.com/menu","description":"Create a dynamic slug with the Assistant.","target":"assistant"}:::

## Short answer

To print hundreds or thousands of QR codes from one short link, one per table, product, serial number or booth, write the part that changes between braces: `menu/{table}` or `p/{serial}`. This is a **dynamic short link**, also called a dynamic slug. On your custom domain, that one link answers every address that fits the pattern, and whatever sits in the braces is saved on the visitor under that name. A scan of `qr.bistro.com/menu/12` opens the link and records `table = 12`.

You manage one link and one workflow, not hundreds. Each code comes in the link's QR design: download one at a time from the dashboard, or render up to 100 per call through the API, an AI agent over MCP, or the CLI. A [visitor data condition](/help/article/how-to-use-visitor-data-conditions) sees the value during the same scan, so table 12 can get the terrace menu, or batch LOT42 a recall page, from the very first visit. A dynamic short link needs a [custom domain](/help/article/how-to-create-branded-links-in-linkbreakers), which every plan includes, Free included.

## Quick summary

- One link prints as hundreds or thousands of QR codes: one per table, product, serial number, batch, booth or sales rep
- On a custom domain, a segment written `{name}` matches any value and saves it on the visitor as `name`
- Every code carries the link's QR design (colours, dot style, shape, logo), as PNG, SVG, JPEG or WebP
- Conditions see the value during the same scan, and it shows on the visitor's profile and timeline, in Slack, in webhooks and in Google Analytics 4
- Creating it spends the credits of one link, however many codes you print
- Exact slugs always win over a dynamic one, so you can still give one value its own link
- Two dynamic slugs that could match the same address are refused, so an address never has two answers
- Available through the dashboard, the REST API, the MCP server, the CLI and the SDKs

## How it works

A slug is the part of a short link after the domain. It can be several segments separated by `/`, such as `menu/lunch` or `spring/poster-a`, on any domain; visit pages and contact cards work under them too. On a custom domain, any segment can also be a variable.

| Slug | Address scanned | What is saved |
|---|---|---|
| `menu/{table}` | `qr.bistro.com/menu/12` | `table = 12` |
| `p/{serial}` | `go.brand.com/p/A7Q2-9931` | `serial = A7Q2-9931` |
| `booth/{booth}/rep/{rep}` | `ev.acme.com/booth/B14/rep/sara` | `booth = B14`, `rep = sara` |
| `01/09506000134352/10/{batch}` | `qr.brand.com/01/09506000134352/10/LOT42` | `batch = LOT42` |

When an address arrives on your domain:

1. Linkbreakers looks for a link whose slug is exactly that address. If there is one, it answers.
2. Otherwise it compares the address with your domain's dynamic slugs, segment by segment. Fixed segments must be equal (upper or lower case does not matter) and each variable segment takes whatever value is there.
3. The matching link runs its workflow, and the captured values are saved on the visitor.

Values keep the case they were printed with: `LOT42` stays `LOT42`. Each variable captures one segment, up to 200 characters.

## One dynamic link or many separate links?

[Bulk insert](/help/article/how-to-bulk-create-qr-codes-in-linkbreakers) does a different job: it creates many separate links from a table or a CSV. Choose by what changes from one code to the next.

| | One dynamic short link | Many separate links (bulk insert) |
|---|---|---|
| Fits when | Every code opens the same workflow and only a value changes | Codes open different destinations or workflows |
| Typical job | One code per table, product unit, serial number, batch, booth or sales rep | One code per campaign, store page or product page |
| Domain | A custom domain | Any domain |
| Credits | 1,000 platform credits once, however many codes you print | 1,000 platform credits per code |
| Changing what opens | Edit one workflow, and every printed code follows | Edit each link, or script it |
| Telling codes apart | The value saved on the visitor | Each link has its own scan count and analytics |
| Making the codes | One at a time in the dashboard, or up to 100 per call through the API, MCP or the CLI. No file upload | A table or a CSV in the dashboard, up to 250 rows per upload |

A plan's monthly credits pay for 5 links on Free, 30 on Light and 250 on Pro, so a print run of one code per item is where separate links run out first. Separate links remain the better fit when each code needs its own destination or expiry date, or when you want a scan chart per code in the analytics dashboard.

## Step-by-step

1. [Connect a custom domain](/help/article/how-to-create-branded-links-in-linkbreakers) if your workspace does not have one yet.
2. Create a link and pick your custom domain.
3. Click **Advanced {}** next to the Short link label. The button only shows once a custom domain is picked. In the **Dynamic short link** dialog, type the pattern with its variables in braces, or start from an example: **One code per item** (`p/{serial}`), **One code per table** (`menu/{table}`) or **GS1 Digital Link** (`01/09506000134352/10/{batch}`). Then click **Use this short link**. Variable names use lowercase letters, digits and underscores, and start with a letter.
4. Build the workflow as usual: a redirect, a form, a [multi-link page](/workflow-steps/multi-link-page), conditions.
5. Click **Download QR code** on the link. In the **Download a QR code** dialog, type a value for each variable, check the code in your QR design, and download it as PNG, SVG, JPEG or WebP. To print tens or hundreds of codes at once, render them through the API, the MCP server or the CLI (see "Print hundreds of codes from one link" below).

The slug and the domain are fixed once the link exists, because printed codes depend on them. To change the pattern, create a new link. What the link opens stays yours to change: edit the workflow, and every code already printed follows.

## Route on the captured value

Add a [visitor data condition](/help/article/how-to-use-visitor-data-conditions) after the scan and test the attribute by its name:

- `table` equals `12` goes to the terrace menu, everything else to the main menu
- `batch` equals `LOT42` goes to a recall notice, every other batch to the product page
- `rep` equals `sara` goes to Sara's booking page

The condition reads the value captured on this very scan, so it works on a visitor's first visit, before anything is saved to their profile.

## Where the values show up

- **The visitor's profile and activity timeline**: the entry step lists what was saved
- **Visitors**: **Filter by attribute** lists who holds a value, such as `table` equals `12`, and **Export CSV** downloads that filtered list. The CSV has no column for the value itself, so filter by value before you export
- **The API and MCP**: on each visitor, like any other visitor attribute, and as a count of visitors per value with `POST /v1/analytics/attributes/distribution` or the `analytics_attribute_distribution` tool, which the Assistant can use too
- **Slack notifications and webhooks**: in the saved attributes of the visit
- **Google Analytics 4**: the [GA4 integration](/help/article/google-analytics-4-integration-for-qr-codes-and-links) sends the names of the fields that were saved and, while **Send visitor data with events** is on, their values as `lb_` parameters; emails, names, phone numbers and addresses are never sent

## Examples

### Serial numbers on products

Create `p/{serial}` and print one code per unit, each with its serial number. Every scan opens the same registration form, and the serial number is already on the visitor's profile when they submit it, with no field to type.

### Tables in a restaurant

One link, `menu/{table}`, and one sticker per table. Filter your visitors by table, and route the terrace to its own menu. Put [a chatbot that suggests dishes from your menu](https://linkbreakers.com/help/article/how-restaurants-use-qr-codes-for-table-ordering-guest-feedback-and-loyalty) in front of it, and each guest's answers sit on their profile next to their table number.

### Booths and sales reps at an event

`booth/{booth}/rep/{rep}` gives every rep their own code on one link. Leads arrive with the booth and the rep who met them, ready for a webhook to assign them in the CRM.

### GS1 Digital Link on packaging

`01/09506000134352/10/{batch}` answers every batch of a product in the [GS1 Digital Link](/help/article/gs1-digital-link-explained) format checkout scanners read. See [GS1 Digital Link QR codes with Linkbreakers](/help/article/gs1-digital-link-qr-codes-with-linkbreakers).

## Exact slugs win

An exact slug always answers before a dynamic one. With `menu/{table}` in place, you can still create `menu/vip` as its own link with its own workflow. The dynamic slug answers every other table.

## From an AI agent or a script

Create the link with the pattern as its `shortlink` and your domain's `custom_domain_id`:

```json
POST /v1/links
{
  "destination": "https://yourbrand.com/menu",
  "shortlink": "menu/{table}",
  "custom_domain_id": "d290f1ee-6c54-4b01-90e6-d701748f0851"
}
```

The same works from the [MCP server](/help/article/mcp-server-setup), the CLI and the SDKs. An agent connected over MCP can create a pattern, then read the captured values back from visitor profiles.

## Print hundreds of codes from one link

The link's own QR code holds the pattern itself (`menu/{table}`), so it is not the one to print: a scan of it opens the link but saves no value. Ask for the codes of the values you print instead. Each comes in the link's QR design, with its colours, dot style, shape and logo:

```json
POST /v1/links/{id}/qrcode-images:render
{
  "items": [
    {"values": {"table": "1"}},
    {"values": {"table": "2"}},
    {"values": {"table": "3"}}
  ],
  "format": "QRCODE_RENDER_FORMAT_SVG",
  "size": 1024
}
```

Each item comes back, in the order you sent them, with its address and a link to its image.

- **Sizes and formats:** PNG, SVG, JPEG or WebP, from 256 to 4096 pixels, 1024 by default. SVG is the better choice for print at any size.
- **Volume:** up to 100 codes per call. For a larger run, call it again with the next 100, so 10,000 codes take 100 calls. A call of 100 new codes takes about 10 to 15 seconds.
- **Image links expire** within 24 hours, so download the files rather than storing the links. Images are kept, so asking for the same code again is instant. Changing the design gives new ones.
- **Scans count as QR code scans:** every address returned ends in `?lbsrc=qrcode`, the marker that records a visit as a scan rather than a click. If you draw the codes with another tool, keep it in the address.
- **Regular links** work too: send one item without values to get the link's code at the size and format you need.

The same call is available wherever you work:

- **AI agents:** the MCP tool is `links_render_qrcode`. "Make me the QR codes for tables 1 to 40" is enough for an agent connected to the [MCP server](/help/article/mcp-server-setup).
- **CLI:** `linkbreakers links render-qrcode-images --id <link id> --data '{"items":[{"values":{"table":"1"}}]}'`.
- **SDKs:** `linksServiceRenderQrcodeImages` in each of them. A scoped API token needs `qrcodes:read`.
- **The Assistant** in the dashboard renders them too.

## Limits and caveats

- **Custom domains only.** On the shared Linkbreakers domain, slugs can have several segments but no variables, since every workspace shares those addresses.
- **One segment per variable.** `{serial}` captures one segment, never a `/`.
- **No overlap.** Two dynamic slugs of a domain that could match the same address are refused: `01/{gtin}/10/{batch}` and `01/09506000134352/10/{lot}` cannot both exist. Make one of their fixed segments different.
- **A variable once per slug.** Each name can appear only once.
- **Path only.** Values in the query string (`?17=261231`) are not saved as attributes.
- **Fixed after creation.** The slug and domain of a link cannot be changed later.
- **Any value is accepted.** A link does not check values against a list. Route the known ones with a condition if some are invalid.
- **Not in the redirect address yet.** The value cannot be inserted in a destination URL. Route on it, or read it in your webhook.
- **One value per name on a visitor.** If the same phone scans table 3, then table 12, the profile shows `table = 12`, and the timeline keeps each visit. So a count per value counts visitors, not scans, and the link has one scan count in analytics.
- **No file upload for values.** The dashboard makes one code at a time, at 1024 pixels for PNG, JPEG and WebP. Lists go through the API, MCP or the CLI.
- **Scans are tracked visits,** as on any link: 500 a month on Free, 5,000 on Light, 50,000 on Pro.

## Next steps

Once the pattern answers, decide what opens behind it. To get the table, the serial number or the rep on every lead, [add a lead capture form to the link](/help/article/how-to-add-a-lead-capture-form-to-a-qr-code). To send some values elsewhere, [use a visitor data condition](/help/article/how-to-use-visitor-data-conditions). Then [set up the QR code design](/help/article/whats-a-qr-code-design) before you print, because every code you render takes it.

## Frequently asked questions

### Is this the same as a bulk QR code generator?

It gets you the same pile of printable codes by a different route. A bulk generator makes one separate link per code. A dynamic short link keeps one link and makes one code per value, which suits one code per table, product or serial number. When codes need different destinations, use [bulk insert](/help/article/how-to-bulk-create-qr-codes-in-linkbreakers) instead.

### My list is in Excel. How do I turn it into QR codes?

It depends on what changes per row. If each row has its own destination, save the sheet as CSV and upload it to [bulk insert](/help/article/how-to-bulk-create-qr-codes-in-linkbreakers), which creates one link per row. If each row is only a value on the same link, there is no file upload: give the column to an AI agent connected over MCP, or loop over the rows in a script and call the render endpoint with 100 values at a time.

### Can I print 10,000 codes?

Yes, in 100 calls of 100 codes from a script or an agent.

### Is it available on the Free plan?

Yes. Dynamic short links need a custom domain, and the Free plan includes one.

### Does it cost extra?

No. Creating the link spends the 1,000 platform credits of any link, once, and rendering codes spends none on any plan. Calls made with an API token count as API calls (250 a month on Free), and scans count as tracked visits, as on any link.

### Do the codes use my QR design?

Yes, every code uses the link's saved design: colours and gradients, dot and corner styles, shape and logo. Change the design and the next codes use it. Codes already printed stay as they are, and keep working.

### What happens if someone types a value that was never printed?

The link answers it like any other value and saves it. If only some values are valid, route the known ones with a [visitor data condition](/workflow-steps/visitor-data-condition) and send the rest to a fallback page.

### Can a dynamic slug have no fixed segment at all?

Yes, `{code}` answers every one-segment address on your domain that has no exact link. It is useful for a domain dedicated to one campaign.

### Can I turn an existing link into a dynamic one?

No, the slug is fixed once printed codes depend on it. Create a new link with the pattern.

### Does matching slow down scans?

No. Exact slugs are looked up first. Dynamic slugs are only compared when no exact slug answers, and they are kept in memory between scans.

### Can I use the captured value in a redirect?

Not yet in the destination address itself. Route on it with a visitor data condition, or read it in your webhook.

## Sources

- Linkbreakers dynamic short links and QR code rendering, checked against the product's code on 2026-11-06.

## Last reviewed

2026-11-06 by Laurent Schaffner.
