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

Each option in a site filter set is configured with one of two filter modes that control how its mapped tags are evaluated:

Match Any

An advocate matches if they have at least one of the option’s mapped tags. This returns the broadest set of results.

Match All

An advocate matches only if they have every one of the option’s mapped tags. 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.

Nearest Advocates First

Visitors don’t have to search to see nearby advocates. When the landing page opens, the map centers on the visitor’s approximate location, based on their internet connection, and the advocate cards are ordered nearest-first. If their location can’t be determined, the map opens on a default view.

Searches lean toward places near the visitor too. A bare name like franklin finds the nearest Franklin. Add a state or province, like boston, MA, to go exactly there from anywhere.

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

Filtering by Advocate Type

Every community also has a built-in Type filter set, which lets visitors filter the map by advocate type. It is off by default. Check Enabled on it to show it. Its options follow your advocate types automatically, so you can’t add, remove, or reorder them by hand, and the set can’t be deleted. Type names become visible on your site once it is enabled.

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

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.

Showing Different Filters on Different Maps

The Enabled checkbox on a filter set controls whether it is available at all. Which enabled sets a particular map shows is set per map:

  • Your community site follows the map marked Shown on your community site in Settings → Maps (the Default Community Map to start). It shows every enabled set until you change it.
  • Embedded maps and map links can each show a different subset, or hide the filter controls entirely.

See Saved Maps to set this up.

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.