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.

Location-Based Search

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.