Advocate Handbook

Write your program’s handbook in Stoked, publish it for advocates and applicants, and record who has agreed to it.


Where to Find It

Go to Settings > Library > Handbook. You need the Can manage settings permission to see Settings (see Managing Team Members).

The page has three cards:

  • Handbook: the built-in handbook’s content and publish setting
  • Advocate agreement: ask advocates to review and agree
  • External handbook: link to a handbook hosted somewhere else instead

New communities start with a draft handbook you can edit. It isn’t public until you publish it.


Editing the Handbook

  1. Go to Settings > Library > Handbook
  2. Optionally set a Page title (up to 100 characters). If blank, it uses “Your community name Handbook”.
  3. Optionally set a Page subtitle (up to 200 characters). If blank, it uses “Your guide to being part of the program.”
  4. Write the body in Handbook content (up to 100,000 characters)
  5. Click Save handbook

The Handbook content editor toolbar has:

  • Bold, italic, underline, text color, and links
  • Numbered and bulleted lists, and Clear formatting
  • Heading 2 and Heading 3 for sections
  • Tables: Insert table, Add row, Add column, and Delete table

Click Preview to see the saved version as it appears on the public page. Save your changes first.

Your Advocate FAQs are added to the bottom of the handbook automatically, under Frequently Asked Questions. Manage them in Settings > Library > Advocate FAQs. See FAQs.


The Call-to-Action Button

When advocate applications are on, the public handbook shows a button at the top and bottom that links to your application page. Set its text in Call-to-action button text (required, up to 100 characters). The default is “Apply to join”.

When applications are off, the field is disabled and the button is hidden. The handbook still saves, and keeps your button text for when you turn applications back on. See Advocate Applications.

The button never appears in the advocate portal.


Publishing

Check Publish to public URL and click Save handbook. The card’s badge changes from Draft to Published, and a View public page button appears.

Once published, the handbook appears in these places:

  • Community site at /handbook, with your logo, the call-to-action button, and the Advocate FAQs that aren’t limited to an advocate type
  • Advocate portal: a Handbook item in the sidebar, and a Read the handbook link in the welcome banner. Advocates see the FAQs for their own type.
  • Application pages: a “Have questions? Read the…” link on the application form, and a Read the handbook button on the thank-you page
  • Emails: the {{handbook_url}} merge variable links to it. The default application-approved, welcome and invite emails use it.

While the handbook is a draft, visitors to /handbook on your community site are sent to your home page, and advocates are sent to their Library.


Using an External Handbook

If your handbook lives on your own website, enter it under External handbook > External handbook URL and click Save external URL. The advocate sidebar, application pages and {{handbook_url}} then point there.

  • You can’t set an external URL while the built-in handbook is published or advocate agreement is on. Unpublish it or turn agreement off first.
  • While an external URL is set, the built-in handbook can’t be edited or published. Clear the URL to use it again.

Advocate Agreement

Ask every advocate to review the handbook and agree to it, and see who has.

Advocate agreement is available on the Pro and Enterprise plans, and only for the built-in handbook. See Plans and Upgrading.

Turning It On

  1. Go to Settings > Library > Handbook
  2. In the Advocate agreement card, click Turn on advocate agreement
  3. Confirm. The prompt shows how many active advocates will be asked to agree.

Advocates are only asked once the handbook is published. New communities start with agreement on. Communities created before the feature launched start with it off.

What Advocates See

The next time an advocate opens the advocate portal, they’re taken to the handbook. Until they click I’ve reviewed and agree, they can only read the handbook or log out. After agreeing, they continue to the page they were going to, and the handbook shows the date they agreed.

Team members viewing the portal as an advocate are never asked, and can’t agree on an advocate’s behalf.

The Agreement link in the card points to the handbook in the advocate portal. Click the copy button and paste it into an email or newsletter. Advocates log in, review the handbook, and agree on the spot.

Tracking Who Has Agreed

The card shows how many active advocates have agreed to the current version, for example “12 of 15 active advocates have agreed to the current version.” Below that, Still waiting on lists up to 25 advocates who haven’t, then “+N more”.

Each agreement is stored with the advocate, the date, and a copy of the handbook and FAQs exactly as they saw it.

Asking Advocates to Agree Again

When agreement is on, the Handbook card has a Require advocates to review and agree again checkbox. Check it before clicking Save handbook when your changes are big enough that everyone should re-read. Every advocate is then asked again at their next visit.

Leave it unchecked for typo fixes and small edits. Advocates aren’t interrupted, and their earlier agreement still counts.

Turning It Off

Click Turn off advocate agreement. Advocates are no longer asked, and existing agreement records are kept.


  • Share PDFs, videos and links alongside the handbook with Library items.
  • If your activities need a signed release from prospects, see Waivers.

Related: FAQs · Library · Advocate Applications


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