Advocate Types

An advocate type says what kind of participant someone is, such as an owner, an ambassador or a bike shop. It shapes how they appear on your map and what they get.


Why Use Advocate Types

Most communities start with one kind of advocate: happy customers. As you grow, you may add others who need different treatment:

  • Owners who answer questions about the product they bought.
  • Ambassadors who get a bigger reward and a different handbook.
  • Shops or dealers who should appear on the map at their exact address, with a shop icon, and show up in Google.
  • Libraries or other venues where people can try the product, but which shouldn’t be messaged like a person.

Types give each kind its own map pin, its own application form, and its own set of rewards, offers, fields and FAQs.

Types are for admins. Prospects never see an advocate’s type unless you turn on the Type map filter (see below). To visitors, everyone on your map is simply an advocate.


Advocate Type or Tag?

Use a type for what someone is. Use tags for what they have or like.

  Advocate type Tags
How many per advocate Exactly one As many as you like
Shown to prospects No (unless you turn on the Type map filter) Yes, if the tag is public
Example Owner, Ambassador, Bike Shop cargo-bike, family, rides-weekends, spanish
Map pin color and message prompt Yes Yes, and a tag wins over the type
Map pin icon Yes No
Exact address on the map Yes No
Listed in search engines by default Yes No
Starting settings for new advocates Yes No
Tied to an application form Yes No
Limits which rewards, offers, fields and FAQs apply Yes No
Suggested by advocates or AI No Yes
Who sets them up Stoked, on request (any admin can view them) Any admin

A simple test: if an advocate could be two of them at once, it’s a tag. If the answer changes what they get or how they’re shown on the map, it’s a type.

Some communities used tags like type/dealer before types existed. Those tags keep working. Once you have types, a type is the better home for “dealer”.


Getting Advocate Types Set Up

Stoked sets up advocate types for you. Contact us with the kinds of advocates you have and what should differ between them, and we’ll create them.

To see your community’s types, go to Settings → Advocate Types. The list shows each type’s name, slug and pin color, which type is the default, and how many advocates have it. Adding, editing, reordering and deleting types is handled by Stoked for now.

Every community already has one type, Advocate, which every advocate belongs to. Nothing changes for you until a second type exists. After that, type menus appear throughout the admin portal.


What a Type Controls

On the map

  • Pin color. A type can have its own pin color. An advocate’s own color wins first, then a tag’s color, then the type’s, then your community default. See Tags & Colors.
  • Pin icon. A type can show an icon inside its pins, such as a storefront for shops.
  • Exact location. Advocates’ pins normally sit at a spot within about a mile of their address, to protect their privacy. For places like shops and libraries, a type can put pins on the exact address.
  • Message prompt. The text in the message box on an advocate’s page can differ by type, unless a tag or the advocate sets their own. See Default Message Prompt.
  • Search engines. A type can let Google list its advocates’ profiles by default, which is useful for shops. Each advocate can still override it under Show in search engines?

Starting settings for new advocates

A type can set whether new advocates of that type can be messaged, are shown on the map, and get location reminders. These apply once, when the advocate is created. Changing them later doesn’t affect existing advocates. Approved applicants are always shown on the map.

What each type gets

When your community has more than one type, these settings show a Limit to types option. Leave every box unchecked to apply to all types.

  • Wallets. If an advocate moves to a type a wallet doesn’t apply to, the wallet is hidden from them and frozen with its balance kept. See Wallets.
  • Offers. An offer limited to other types acts as inactive for this advocate. See Offers.
  • Custom fields. See Custom Fields.
  • Tag groups. See Tag Groups.
  • Library items.
  • Advocate FAQs. An advocate’s handbook shows only the FAQs for their type.

Applications

Each application form can set an Advocate type, so everyone who applies with your “Shop” form becomes a shop. You can still pick a different type when you approve. See Application Forms.


Give an Advocate a Type

  • When you approve an application: the type from the application form is pre-selected next to Approve. Change it there if you need to.
  • On the advocate’s page: pick from the Type menu under Status. It saves right away.
  • When you add an advocate: choose a Type on the form.
  • By CSV import: add a type column with the type’s name. Leave it blank to use your default type. See Importing Advocates.

New advocates get your default type unless you choose another.


Find Advocates by Type

  • Advocates list: use the Type filter, or search for type: followed by the type’s slug, such as type:shop. The slug is usually the type’s name in lowercase.
  • Inbox: use the Type menu.
  • Your map: the Type filter set lets visitors filter your map by type. It’s off until you turn it on under Settings → Tags → Site Filter Sets. Turning it on makes your type names visible on your site. See Community Site Filtering.
  • CSV export and the API both include each advocate’s type.

Related: Tags & Colors · Map-Only Advocates · Managing Advocate Status · Application Forms


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