Build a link to share filtered event search

This article explains how to create a sharable URL that, when opened, takes people to a filtered list of events. This URL uses event tags to filter the events on the Upcoming events page.

When you want to send a link to someone and show them a list of events instead of a single event, you can build a custom URL. Using the event tag to filter the list, you can add the tags to the end of a URL and share the link. When someone opens the link, they open the Upcoming events page filtered for the event tags you included. 

When you build a link with multiple event tags, it filters the list for events that include any of the tags you include. For example, if you filter for Engagement, Leadership Development, and Event Management, the filtered list includes events with the Engagement, Leadership Development, or Event Management tags. That is, it doesn't just include events with just those three tags.

Build a link with one event tag

1. On the Upcoming events page, add the following to the end of the URL:
   /#/list?tags=
   Your URL should now look something like https://events.cmxhub.com/events/#/list?tags=
2. Add the event tag to the end of the URL that you want to filter for. If the tag is more than one word, replace any spaces with %20.
   For example, https://events.cmxhub.com/events/#/list?tags=Engagement or https://events.cmxhub.com/events/#/list?tags=Leadership%20Development.
3. Copy the URL, and then share the link.

When you add tags to the URL, they must be exactly the same as they are in the Event tags field. If you change the capitalization or remove spaces, the link won't work. 
Event tags display below the event name. You can copy the tag from here to paste in the URL.
If the tag contains more than one word, replace spaces with %20. This makes it easier to share the URL in different places.

Build a link with multiple event tags

Build a link with as many event tags as you want to filter by. Separate the tags with a comma.
This filters the list for events that include any of the tags you include.

1. On the Upcoming events page, add the following to the end of the URL:
   /#/list?tags=
   Your URL should now look something like https://bevy.bevy.com/events/#/list?tags=
2. Add event tags to the end of the URL that you want to filter for. Separate the tags with commas, and replace any spaces with %20.
   For example,https://events.cmxhub.com/events/#/list?tags=Engagement,Leadership%20Development,Event%20management.
3. Copy the URL, and then share the link.

Event tags can only contain letters, numbers, colons (:), semicolons (;), apostrophes ('), and hyphens (-).
This means that existing tags that include commas can't be used. If there's a tag you want to include that contains commas, you need to edit the tag in the admin dashboard and remove the commas. In the admin dashboard > Settings > Event Tags, replace any commas with semicolons or colons, and then save your change. For example, if you want to include the Diversity, Equity, and Inclusion tag, you need to change it to either Diversity; Equity; and Inclusion or Diversity: Equity: and Inclusion.