QUERYPARAMS

Retrieves a query parameter value from the current page URL. Use QUERYPARAM to read URL parameters directly in your formulas.

Syntax

QUERYPARAM("parameter_name")

Parameters:

• parameter_name (String) – The name of the query parameter to retrieve

Returns: The parameter value as text, or empty if not found.

Key matching rules

• Case-insensitive: QUERYPARAM("Source") and QUERYPARAM("source") both work

• Value is case-sensitive: The returned value preserves the exact case from the URL

• Returns empty when missing: Use IF or ISEMPTY to handle missing parameters

Using QUERYPARAM in formulas

Apply a dynamic discount from URL

IF(QUERYPARAM("discount") = "PARTNER50",
   TOTAL * 0.5,
   TOTAL)

Customize messaging based on campaign

IF(ISEMPTY(QUERYPARAM("utm_source")),
   "Welcome!",
   CONCAT("Welcome from ", QUERYPARAM("utm_source")))

Pre-fill calculations with URL values

IF(ISEMPTY(QUERYPARAM("qty")),
   1,                    // Default quantity
   NUMBER(QUERYPARAM("qty")))  // Use URL value

Pre-filling questions with query parameters

Pre-fill questions in your form or calculator using URL query parameters. When users visit your page with parameters in the URL, the specified questions automatically show default values.

How it works

Query parameters let you pass data into your calculator or form through the URL. This is useful for:

• Pre-filling user information from email campaigns

• Passing values between calculators

• Personalizing experiences based on external data

Unlike EMBEDPARAM, which reads custom parameters passed through embed code for use in formulas, query parameters set default values for questions that users see when the page loads.

Enabling query parameters on a question

1. Open your calculator or form in the editor

2. Select the question you want to pre-fill

3. Go to the question's logic settings

4. Toggle on Set default value from query parameter

5. Enter the parameter name you'll use in the URL

URL syntax

Add parameters to your calculator or form URL:

https://app.convertsite.co/to/YOUR_ID?parameter=value

For multiple parameters, join them with &:

https://app.convertsite.co/to/[email protected]&name=John

Supported question types

Each question type expects a specific value format in the URL:

Number

Pass a plain number:

?price=80

Radio / Dropdown

Pass the option value (must match a unique value in your options):

?plan=premium

Yes/No

Use 1 for Yes, 0 for No:

?newsletter=1

Text field

Pass any text value. Use + for spaces:

?name=Michael+Bluth

Email

Pass an email address:

[email protected]

Date

Use yyyy-mm-dd format:

?start-date=2021-08-01

Date range

Pass two dates separated by |:

?timeframe=1999-09-01|2021-09-01

Time

Use 24-hour format HH:mm:

?start-time=22:23

Examples

Pre-fill contact information from an email link

Send personalized links in your email campaigns:

https://app.convertsite.co/to/[email protected]&company=Acme+Inc

When Sarah clicks the link, her email and company name are already filled in.

Pass values between calculators

Use formula interpolation to send calculated values from one calculator to another:

https://app.convertsite.co/to/detailed-quote?area={{#formula}}VA{{/formula}}&email={{#formula}}QB{email}{{/formula}}

This passes the calculated area value and email from the first calculator into the second.

Conditionally show content based on a parameter

Use query parameters with logic conditions:

Set up a question with a default value from ?source=partner, then use that question in visibility conditions to show partner-specific content or discounts.

Limitations

Common mistakes

• Wrong value format: Make sure the value matches what the question expects — use 1 or 0 for Yes/No questions, not "yes" or "true"

• Non-unique radio values: Radio and dropdown options must have unique values for matching to work

• Missing URL encoding: Special characters in text values may need URL encoding (spaces as + or %20)

• Parameter name mismatch: The parameter name in the URL must exactly match what you configured in the question's logic settings

See also

EMBEDPARAM — Read custom parameters in formulas for embedded calculators