Pass-through parameters let URL parameters — such as UTM tags, campaign IDs, or custom identifiers — flow automatically from a QR Code or Linkpage into your Form responses. Every submission captures the source context it arrived with, so you can attribute responses to specific campaigns, placements, or individual users without asking respondents to self-identify.
Prerequisites
Pass-through parameters for Forms are available on all paid plans.
Any Editor or Admin who can create Forms can set up pass-through parameters.
How pass-through parameters work
When a respondent scans a QR Code or taps a Linkpage button that has URL parameters attached, those parameters are automatically carried into the Form and recorded alongside the submission — no additional configuration is needed.
This works across three common flows:
QR Code → Form — Parameters added to a Form QR Code are captured when the Form is submitted.
Linkpage → Form — Parameters on a Linkpage button URL are passed through when the respondent opens and submits the linked Form.
QR Code → Linkpage → Form — Parameters flow end-to-end: from the QR Code scan through the Linkpage, and into the final Form response.
Pass-through parameters appear in your Form response table in the Uniqode dashboard and in all CSV, Google Sheets, and Excel exports.
Add pass-through parameters to a Form QR Code
Go to Create New in the top-right of your dashboard.
Choose QR Code from the dropdown menu.
Select Form as the QR Code type.
Choose your Form from the dropdown menu, or paste a copied Form URL into the input box.
Click Parameters.
Click Add New Parameter under Manage Parameters.
Enter a Parameter name and its corresponding Value.
Click Add New Parameter to confirm. You can add up to 5 parameters. Common examples such as `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, and `utm_content` are suggested in the dialog box for easy setup.
Click Save, then click Next to customize and finish creating your QR Code.
Add pass-through parameters to a Linkpage that links to a Form
Go to Create New in the top-right of your dashboard.
Choose QR Code from the dropdown menu.
Click on Linkpage as the dynamic QR Code type.
Choose the Linkpage that contains your Form button from the dropdown menu.
Click Parameters.
Click Add New Parameter under Manage Parameters.
Enter a Parameter name and its corresponding Value, then click Add New Parameter. Parameters added here are passed to all button URLs on the Linkpage, including buttons that link to Forms.
Click Save, then click Next to continue.
Note: Pass-through parameters are not shown in the Forms Analytics.
Limits and behavior
You can pass a maximum of 5 key-value pairs per submission. If more than 5 are present in the URL, only the first five are captured.
The total length of all passed parameters combined can be up to 512 characters, which accommodates long user IDs and campaign identifiers.
All key-value pairs must use `&` as the separator (e.g. `?utm_source=lobby&location=orlando`).
Parameters are captured fresh on every scan — caching will not cause stale parameters to be recorded if a respondent opens the Form with updated values.
The 5-parameter quota applies only to your custom parameters. Uniqode's internal parameters (such as source ID, source name, and source text used by the Insights program) are not counted toward this limit.
Parameters are not pre-filled by Uniqode. All values must be supplied in the URL by you.
Pass-through parameters do not-
Apply to non-Form elements on a Linkpage (e.g., they will not dynamically change page text or images).
Persist across sessions — if a user returns to a Form later without the original URL parameters, they are not retroactively applied to a new submission.
Common use cases
Campaign attribution
Add `utm_source`, `utm_medium`, and `utm_campaign` to QR Codes placed in different locations (e.g. `utm_source=lobby`, `utm_source=print_ad`). Each Form response will show exactly which placement drove it.
CRM and user identification
Pass a user ID or CRM identifier (e.g. `user_id=12345`) in the URL of a Form link sent to a specific individual. Their submission is automatically tagged with their ID, without asking them to fill it in.
Multi-touch loyalty and events
Link QR Codes at different activation points in an event or loyalty campaign. Unique parameter combinations on each code let you pinpoint which touchpoint converted each respondent.