Who This Is For / When to Use
This article is for Kyrios users who want to pre-fill form fields using contact data when sending links via SMS, email, or other trigger-link-enabled campaigns. Use this when you want to reduce manual input and personalize form experiences for existing contacts.
What a Query String Does in Kyrios Forms
A query string passes existing contact field values into a Kyrios form by appending field-specific parameters to the form URL used in a trigger link. When the link is clicked by an existing contact, Kyrios automatically populates matching form fields using the query keys defined in the form.
Step 1: Open the Form You Want to Pre-Fill
To pass data into a form, the form must first be configured with query keys.
Go to Sites → Forms.
Open the form you want to use.
Click Edit to enter the form builder.
Step 2: Set the Query Key for Each Form Field
Each form field must have a query key that matches the parameter used in the trigger link.
Click a form field (for example, First Name).
In the right-side settings panel, locate Query Key.
Enter a value such as
first_name.Repeat for every field you want to pre-fill (for example,
last_name).
The query key is case-sensitive and must exactly match the parameter used in the URL.
Step 3: Copy the Form Share Link
The trigger link must use the form’s public share URL.
In the form editor, click Integrate.
Select Share.
Copy the form URL.
Step 4: Create a Trigger Link
Trigger links are used to send the form URL through campaigns while tracking engagement.
Go to Marketing → Trigger Links.
Click + Add Link.
Enter a name for the trigger link.
Paste the copied form URL into the Link URL field.
Step 5: Append Query Strings to the Trigger Link
Query strings are added to the end of the form URL to pass contact data.
Syntax Rules
Start the first parameter with
?Use
&to add additional parametersUse Kyrios contact merge fields as values
Example: Passing First Name
?first_name={{contact.first_name}}
Example: Passing First and Last Name
?first_name={{contact.first_name}}&last_name={{contact.last_name}}
Once saved, this trigger link will pre-fill the corresponding form fields when opened by an existing contact.
How Query Strings Work with Contacts
Query strings only populate data for existing contacts in your Kyrios account. If the recipient is not already a contact, the form will load without pre-filled values.
Common Issues and Fixes
Form Fields Are Not Pre-Filling
Cause: The query key in the form does not match the parameter in the URL.
Fix: Ensure the form field’s query key exactly matches the parameter name used in the trigger link (for example, first_name).
Data Does Not Populate for Some Recipients
Cause: The recipient does not exist as a contact in Kyrios.
Fix: Confirm the contact record exists before sending the trigger link.
Multiple Fields Not Working
Cause: Incorrect use of ? and & symbols.
Fix: Use ? only once for the first parameter and & for every additional field.
Frequently Asked Questions
What are query strings used for in Kyrios?
Query strings are used to pass existing contact data into forms through trigger links, allowing fields to be pre-filled automatically.
Can I pass multiple fields in one trigger link?
Yes. Multiple fields can be passed by separating parameters with & in the URL.
Is there a limit to how many fields I can pass?
While modern browsers support long URLs, it is best practice to pass only essential fields to avoid overly long links, especially in SMS or mobile email apps.