URL parameters, also known as query strings, pass information to and from a website by appending it to the URL. When it comes to forms, you can use them to pre-populate fields as soon as the form loads.

Key Points

  • Each form field that can be pre-filled using URL parameters has a unique query key.
  • Not all field types support URL parameters. Signature fields and dropdowns, for example, cannot be pre-populated this way.

To pre-fill form fields using URL parameters, follow these steps:

Identify the Query Key for Each Field

In the form builder, each field that supports URL parameters will have a query key. Note these keys down, as you'll need them when constructing your URL.

Constructing the URL

Start with the base URL of your form, then add a question mark ? to mark the beginning of your parameters.

For each field you want to pre-fill, add the query key followed by an equals sign = and the value you'd like to populate. Separate multiple parameters with an ampersand &.

Practical Example

Say you want to pre-fill a form with a first name, last name, state, and email address. With the following query keys:

  • First Name: first_name
  • Last Name: last_name
  • State: state
  • Email: email

Your URL would look something like this:

http://yourformurl.com?first_name={{contact.first_name}}&last_name={{contact.last_name}}&state={{contact.state}}&email={{contact.email}}

You can share this URL with the recipient through any communication channel. Each custom field will be populated dynamically based on the information in their contact card. If any fields are empty, the link will still work and the corresponding form fields will simply remain unfilled.

📌Note: Only contact custom fields and custom values can be used in URL parameters; opportunity custom values will not populate any data.

Testing and Troubleshooting

Once you've built your URL, test it to confirm the fields are pre-filling as expected.

Navigate to the URL you've constructed. The form should load with the relevant fields already filled in.

If a field isn't pre-filling, double-check the query key for any typos.

Also make sure there are no spaces or special characters in the values, as these can break the URL.

Frequently Asked Questions

Can I pre-fill dropdowns or signature fields using URL parameters?

  • No, these field types do not support pre-filling via URL parameters.

Is there a limit to how many fields I can pre-fill using URL parameters?

  • There's no set limit, though very long URLs can become unwieldy or run into browser limitations.