Guide
Managing Links
Everything you can configure on a short link — from slugs and UTM parameters to smart routing rules and expiry dates.
Slugs
A slug is the short path appended to your domain (e.g. linkwi.sh/summer-sale). Slugs must be 2–64 characters, containing only letters, numbers, hyphens, and underscores.
Leave the slug field blank when creating a link to have clicksdk auto-generate a short, unique code using nanoid.
Smart Routing (Weighted & Conditional)
Smart routing lets you send different visitors to different destination URLs based on rules. Two modes are available:
Weighted split
Distribute traffic across multiple URLs by percentage. Useful for A/B testing offers or landing pages. Weights must sum to 100.
Conditional (If / Else)
Route based on visitor attributes: country, device type, referrer domain, or time of day. Define one or more “if” rules, each with its own destination URL; set a fallback “else” URL for visitors that match no rule.
Link Groups
Groups are named buckets that organise links (e.g. Brand Campaigns, Coupon Links). Assign a group when creating or editing a link. You can then filter the Analytics and Logs pages by group to isolate performance data.
Manage groups under Groups in the sidebar. Groups can be renamed at any time — existing links retain the association.
Tags
Tags are freeform labels you attach to a link for ad-hoc filtering. Unlike groups, a link can carry multiple tags. Use them to mark links by promotion type, traffic source, or testing status.
Parameter to Data Mapping
Parameter to Data Mapping is where you configure both UTM parameter injection and any custom data capture. Each mapping reads a query parameter from the incoming click URL and stores its value as a named data field on the click record. Configure mappings in the Config tab of the link editor.
Each mapping has three fields: the query parameter name to read from the click URL, the data key to store the value under (e.g. utm_source, custom_str_1), and an optional default value.
To inject UTM parameters, add a mapping for each UTM key you want to set (e.g. utm_source, utm_medium, utm_campaign) and supply a fixed default value (without curly braces). The value is then recorded on every click from that link regardless of whether the parameter was present in the incoming URL.
| Default Value entered | Behaviour |
|---|---|
{organic} (curly braces) | Fallback. If the parameter is present and non-empty in the click URL, that value is recorded. If the parameter is absent or empty, organic is recorded instead. |
organic (no curly braces) | Fixed. The value organic is always recorded, regardless of what the parameter contains in the click URL. |
| empty | No default. If the parameter is absent from the click URL, the data key is recorded as empty. |
This covers both UTM injection and any custom data capture — all in one place, without requiring those parameters to be appended to every link by the traffic source.
utm_medium = affiliate on every click from a specific link. Use a fallback value (curly braces) when the parameter may or may not be present in the click URL and you want a sensible default when it is absent.Link Expiry
Link expiry is configured inside the IF Rules section of the link editor. Add a condition with a Date / Time rule and set the expiry date and time. Once the condition matches, visitors are forwarded to that rule's destination URL instead of the primary destination. This is useful for limited-time offers.
Deleting Links
Deleting a link is permanent. All associated click logs and analytics data are retained for reporting but the slug is released and may be reused. To disable a link temporarily without losing its slug, set the destination to a placeholder page or disable it via the API.