Community Site Filtering

Allow visitors to find the right advocates on your community site using tag-based filters and location search.

How Tag-Based Filtering Works

Tags you assign to advocates can be used to filter the community site. When filters are active, the map and advocate list update to highlight advocates who match the selected tags while still showing all other advocates.

  • Matched advocates appear in full color on the map with higher visual prominence
  • Non-matching advocates appear greyed out on the map but remain visible and clickable
  • The advocate card list shows up to 5 cards at a time, prioritizing matched advocates and filling remaining slots with nearby advocates

Filtering never hides advocates from the map. Visitors always see a full, active community.

Filter Modes

Stoked supports two filter modes that control how multiple tags are evaluated:

Match Any (Default)

An advocate matches if they have at least one of the selected tags. This is the default mode and returns the broadest set of results.

Match All

An advocate matches only if they have every selected tag. Use this mode when visitors need to find advocates who meet multiple criteria simultaneously.

Visitors can search for advocates near a specific location using the search bar on the landing page.

  1. Enter a city, state, or zip/postal code in the Find someone near… search field
  2. Press Enter or submit the search

The map re-centers on the searched location, and the advocate card list updates to show the closest advocates. Location search works independently of tag filters and can be combined with them.

How Visitors Use Filters

Filters are applied through URL query parameters, making filtered views shareable and linkable from ads, emails, or other marketing channels.

A filtered URL follows this format:

https://your-community.stokedhq.com/?tags=spanish,rentals&match_mode=any
  • tags accepts a comma-separated list of tag names
  • match_mode accepts any (default) or all

When filters are active, visitors see a Filtered by row showing the active tag filters as labeled chips with a Clear button to remove all filters.

Configuring Which Tags Appear

The tags available for filtering come from your advocate tag setup in the admin portal.

  1. Go to Settings in the admin navigation
  2. Click Tags, then select Advocate Tags
  3. Create or edit tags as needed

Tag Display Types

Each advocate tag has a display type that controls where it appears:

  • Always Visible - the tag appears on advocate cards and profiles, and can be used for filtering
  • Profile Visible - the tag appears only on individual advocate profile pages
  • Internal - the tag is hidden from visitors entirely and does not appear on the community site

Only tags with the Always Visible display type appear as filter chips on the community site landing page. Set tags to Internal if they are for admin use only.

For details on creating tags, setting colors, and configuring pin color effects, see Profile Tags with Colors.

Site Filter Sets

Site filter sets add dropdown menus to your community site that let visitors filter advocates without needing to know your tag names. Each dropdown groups related tags into friendly, labeled options.

For example, a bike community might create a Riding Style dropdown with options like Road, Mountain, and Touring — each mapped to one or more advocate tags behind the scenes.

Creating a Filter Set

  1. Go to Settings > Tags > Site Filter Sets
  2. Click Add Filter Set
  3. Enter a name (this is the dropdown label visitors see)
  4. Check Enabled to make it visible on the community site
  5. Click Create

Adding Options to a Filter Set

Each option in a filter set represents one choice in the dropdown. Options are mapped to advocate tags to determine which advocates match.

  1. From the filter set edit page, click Add Option
  2. Enter a Label (the text visitors see in the dropdown)
  3. Optionally select an Icon to display next to the label
  4. Choose a Match Mode:
    • Any (OR) — matches advocates with at least one of the selected tags
    • All (AND) — matches only advocates who have every selected tag
  5. Select the Advocate Tags this option should filter by
  6. Click Create

How Filter Sets Work on the Community Site

When a visitor selects an option from a filter set dropdown:

  • The map highlights advocates matching the option’s tags
  • The advocate list shows matched advocates first, with nearby non-matching advocates below
  • The Filtered by row shows the active selection with a Clear button
  • Filter set selections can be combined with location search and direct tag filters

When multiple filter sets are active, advocates must match all active selections to appear as matched.

Filter set selections are stored in the URL, so visitors can bookmark or share filtered views. The URL format is ?filter[filter-set-id]=option-id.

Example Setups

Here are some ideas for how different communities might use filter sets:

  • Bike community: A “Riding Style” dropdown with options like Road, Mountain, Gravel, and Touring
  • Language learning: A “Language” dropdown with options like Spanish, French, and Mandarin
  • Real estate: A “Specialty” dropdown with options like Residential, Commercial, and Luxury
  • Fitness studio: A “Class Type” dropdown with options like Yoga, HIIT, and Pilates

Ordering and Managing Options

Use the up/down arrow buttons on the filter set edit page to reorder options. The order you set here is the order visitors see in the dropdown.

To remove a filter set or option, click into it and use the Remove button.

© 2024-2026 Stoked — Real conversations. Real trust.