Skip to main content

Adding tags to your maze URL

Laura Cunha
  • Updated

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

You can also follow the video tutorial in Maze University: Customizing your maze URL

Use cases

  • Tester identification. If you already know who your testers are, you can use URL tags to generate a unique tester link and pass in identifiable data about the tester (such as name, gender, email, etc.) in your results dashboard. This approach works best if you're using a third-party service to send out the maze links that allows you to pipe the identifying information into the link you share with them. Learn more in the section Generating custom URLs below.
  • Completion tracking. If you need to track which participants completed your maze (for instance, for compensation purposes), you can pass an external tester ID as a URL tags.
To pass this information back to the original panel provider, you can set up a redirect at the end of the maze.

Before you start

  • You can only use tags when sending the maze URL to your own testers. URL tags are not available when using Maze's panel of hired testers.
  • URL tags are not currently 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.

Using tags in your maze URLs

Maze uses a simple nomenclature to help you record data.

This is an example of a maze test URL:

t.maze.co/74641933

And this is the same test URL with a custom tag:

t.maze.co/74641933?source=slack

By sending that second URL to a tester, we will record the following additional information in the results dashboard:

  • Source: Slack

You can chain as many tags as you want, and we will automatically associate the data with your tester: t.maze.co/74641933?source=slack&category=toast&...

Once your tester completes a mission, you will be able to see this data by clicking Show more button in the Testers tab of the Results page.

maze-resuls-custom-metadata.webp
For a detailed explanation of how to read the dashboard and all the data in it, read our guide: Maze results

Generating custom URLs

You don't have to manually add tags to each individual 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 the URL dynamically.

For instance, 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 could potentially use to generate and distribute custom URLs, such as:

Related articles