Skip to main content

Adding tags/parameters to your maze URL

Laura Cunha
  • Updated

Maze allows you to add tags/parameters to your maze URL to record custom metadata on individual sessions.

Use cases

  • Communication. You can use parameters to identify the source of your testers (e.g. social media, website, ads)
  • Participant identification. If you already know who your testers are, you can use URL parameters to generate a unique tester link and pass in identifiable data about the tester (such as name, gender, etc.) in your results. This approach works best if using a third-party service to send out the maze links that allows you to pipe the identifying information into the share link. Learn more about generating custom URLs
  • Completion tracking. If you need to track who completed your maze (for example, for compensation purposes), you can pass an external tester ID as a URL parameter.
  • Language settings. You can force the testing UI to be translated into any supported language by adding a language parameter to the URL. Learn more about changing the language of the test interface
  • Disable tester tracking. This can be useful when sharing/testing your live maze internally, and you don’t want those interactions to be recorded. To disable tester tracking, add the ?notrack=true parameter to your maze link. Learn more about sharing options
  • Disable unique sessions. This can be useful when testing with multiple users on the same device. To disable unique sessions, add the ?guerilla=true parameter to your maze link. Learn more about sharing options

Before you start

  • You can only use tags when sending the maze URL to your own testers. URL tags aren’t available when using Maze’s panel of hired testers.
  • URL tags aren’t supported when sending out Reach campaigns.
  • URL tags aren’t supported in the PWA.
  • The tags id, createdAt, email and userId are already in use. Please don’t use them as they won’t register your information.

How to add parameters to your maze URLs

Maze uses a simple nomenclature to help you record data. To add your own URL parameters, you’ll use the following nomenclature: ?key=value

This is an example of a maze share link:

t.maze.co/74641933

You’ll manually add your parameters to the URL.

This is the same maze share link with a custom parameter:

t.maze.co/74641933?source=slack

By sending that second URL to a tester, Maze records the following additional information in the Results dashboard:

  • Source: Slack

Generating custom URLs

You don’t need to add tags manually to each link you send.

If you send your test links via a third-party tool, they may have features that allow you to pipe the custom data in to the URL dynamically.

For example, you could send out URLs that include the following (example) syntax:

t.maze.co/74641933?name={{firstName}}&gender={{gender}}

While we don’t directly support or endorse them, there are several products you may use to generate and distribute custom URLs, including:

You can chain as many static and/or parameters as needed — Maze automatically associates that data with your tester. For example:

t.maze.co/74641933?source=slack&name={{firstName}}&testerid={{Id}}...
To pass this information back to the original panel provider, you can set up a redirect at the end of the maze.

Finding parameters data in the Results dashboard

Once a participant completes a mission, the recorded data appears on the Results page. Learn more about the Maze results dashboard

Here’s how to view the parameters data:

  1. Once you’ve started receiving responses, open your Results dashboard.
  2. Navigate to the Testers tab.
    maze-results-testers-tab.webp
  3. Under each tester, click Show more to reveal the custom metadata recorded for that tester.
    maze-results-testers-tab-show-custom-metadata.webp
  4. Any data passed from the parameters will be visible under the Custom section.
    maze-results-testers-tab-custom-metadata.webp
It isn’t directly possible to apply recorded metadata ‌as filters in the Results dashboard. However, if you’re on a paid plan, this data is accessible in the full .csv export. You can use the filter function in your spreadsheet application (such as Google Sheets filters) to achieve this.

Exporting

If you’re on a paid plan, the data passed in the URL parameters is also available in the full .csv export. 

You’ll find it in a single JSON object, under the meta column in the exported file.

Still need help?

If you have any questions or concerns, please let our Support team know — we'll be happy to help!

Related articles