Skip to main content
Tags are free-form labels on links and QR codes. They are how you find things again once you have more than a few hundred.

Tagging at creation

Adding is additive — existing tags stay.

Removing

From one link:
The tags module has its own remove_tags, and calling it without docname deletes the tag from every one of your links, not just one:
Both return 200. Pass docname unless you genuinely mean the second one.

Filtering by tag

Several tags narrow the result — links must carry all of them:
Works the same on get_qrcodes and search_shortlinks.

Listing tags

Paginated like any other list. Supports search.

A scheme that holds up

Tags are created by being used, so without a convention you end up with email, Email and e-mail as three separate tags. Use a prefix per dimension:
Then filtering by dimension is obvious, and a typo is visible rather than silently creating a fourth tag. Normalise in code:
Tags are for how you organise links. UTM parameters are for how your analytics tool attributes traffic. Use tags to find links in Dashlink; use UTMs to attribute sessions elsewhere. They are not substitutes.