Searching Advocates

Find advocates quickly using the search bar, structured query syntax, status filters, distance-based location search, and the Map view.

The search bar on the Advocates page matches against multiple fields at once. Type any of the following into the search bar to find matching advocates:

  • Name - first name, last name, or full name
  • Identifier - the advocate’s unique profile handle
  • Phone number - full or partial phone number
  • Email address - full address, domain, or username portion
  • Bio and headline - text from the advocate’s profile description

Search is case-insensitive and includes fuzzy matching, so minor typos still return relevant results. Exact identifier matches are prioritized over other field matches.

You can also type a ZIP code, city, state, or address to find advocates near that place. See Distance-Based Search.

Structured Query Syntax

You can combine filters directly in the search bar using a key:value format. Unqualified text is treated as a general search term.

Key Description Example
status: Filter by advocate status status:active
type: Filter by advocate type (only when you have more than one type) type:ambassador
location: Search near a ZIP code, city, state, or address location:43065
distance: Limit a location search to a radius (used with location:) distance:50
contact: Has or is missing a phone or email contact:no_phone
visibility: Shown on or hidden from the public map visibility:hidden
sms: Opted in to or out of texts sms:opted_out
tag: Has a tag (group/name), or tag:none for untagged tag:model/q45

Click Search by next to the search box for the full list. See Searching and Filtering for more on tokens.

Examples

  • Jones status:active - find active advocates named Jones
  • 43065 - find advocates nearest to ZIP code 43065
  • location:"Athens, OH" distance:100 - find advocates within 100 miles of Athens, OH
  • sms:opted_out - find advocates who have stopped texts

Wrap location values that contain spaces or commas in quotes: location:"New York, NY".

Status Filtering

Use the Status dropdown to filter advocates by their current status. Available options are:

  • Active - advocates who have completed onboarding
  • Pending - advocates who have been invited but have not yet activated
  • Inactive - advocates who have been deactivated
  • All - show every advocate regardless of status

When no status filter is applied, the default view shows active and pending advocates.

You can also combine multiple statuses in the search bar: status:active,pending.

The same dropdown also filters by:

  • Visible on Map / Not Visible on Map - whether the advocate’s pin shows on your public map
  • SMS Opted In / SMS Opted Out - whether the advocate has texted STOP. Opted-out advocates don’t get texts until they reply START; email and conversations still work.

Each option shows a live count. Click a selected option again to clear it.

To find advocates near a specific location:

  1. Type a ZIP code, city, state, or address in the search bar.
  2. Optionally add distance: followed by a number to limit results to that radius.
  3. Press Enter to search.

Results are sorted by proximity, with the closest advocates listed first. Without distance:, there’s no radius limit, so you always see the nearest advocates. Distances are in miles unless you add km (distance:40km).

If what you type matches an advocate by name, identifier, or profile text, you get that advocate instead. Stoked treats the search as a place only when nothing matches by text. When it does, the search box changes to the explicit form, for example location:"43065", so you can see how it was read. Typing location: yourself always runs a location search.

Map View

Click Map next to the search box to see advocates on a map instead of in a table. Click List to switch back. Your search and filters carry across both views.

  • The map shows the advocates on your public community map that match your search, whatever their status. Advocates hidden from the map or without a location appear only in the List view.
  • Hover a pin to see the advocate’s photo, location, status, and tags, with buttons for View Profile, Introduce (active advocates only), and View Public Profile.
  • Click a pin to open the advocate’s admin profile.
  • With a location search, the map centers on the place you searched and marks it with its own pin. Hovering an advocate’s pin shows how far away they are.

Exporting Search Results

You can export your current search results to a CSV file. The export respects any active search and filter criteria.

  1. Apply your desired search terms and filters.
  2. Click the Export CSV dropdown in the top right corner.
  3. Select a format:
    • Basic - name, contact info, location, status, and conversation count
    • Profile - basic fields plus bio, headline, display settings, and profile links
    • Wallet - name, contact info, and wallet balances

The downloaded file includes all matching advocates, not just the current page.

Pagination

Results are paginated with 25 advocates per page by default. Use the per page selector to switch between 25, 50, or 100 results per page. Navigate between pages using the Previous and Next controls.


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