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
- Go to Settings > Library > Handbook
- Optionally set a Page title (up to 100 characters). If blank, it uses “Your community name Handbook”.
- Optionally set a Page subtitle (up to 200 characters). If blank, it uses “Your guide to being part of the program.”
- Write the body in Handbook content (up to 100,000 characters)
- 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
- Go to Settings > Library > Handbook
- In the Advocate agreement card, click Turn on advocate agreement
- 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.
Sharing the Agreement Link
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.
Related Content
- 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