Skip to main content

How to Use Custom URL Parameters in Your Clustdoc Application

Updated today

Clustdoc allows you to pass custom information into an application via the URL using custom_ parameters. These values are automatically captured and stored when a client accesses your portal.

This is especially useful for:

  • Tracking UTM sources (e.g. Google Ads, email campaigns)

  • Passing internal identifiers

  • Customizing the applicant experience

How It Works

When someone visits your application portal with a URL like this:

https://yourportal.clustdoc.com/cp/1234567-xxxyyyzzz?custom_utm_source=google&custom_agent_id=42

Clustdoc will:

  • Detect any parameter prefixed with custom_

  • Save the values into the newly created application

  • Make them available via merged fields

Example

URL visited:

https://yourportal.clustdoc.com/cp/1234567-xxxyyyzzz?custom_utm_campaign=summer2025&custom_ref_code=alphaX

Captured values:

  • utm_campaignsummer2025

  • ref_codealphaX

These values will be stored and accessible in your workflows.

Reusing the Data with Merged Fields

You can display these values in messages, document templates, instructions, etc., using the following merged field format:

{CUSTOM_FIELD_DATA.fieldname}

Using the earlier example:

  • {CUSTOM_FIELD_DATA.utm_campaign}summer2025

  • {CUSTOM_FIELD_DATA.ref_code}alphaX

Read this article to know more about Merged fields

💡 Best Practices

  • Use lowercase and underscores for consistency (e.g., custom_agent_id)

  • Avoid special characters or spaces in the parameter names

  • Test the link before sharing it with clients

Did this answer your question?