Help Center › Getting started

Getting started

What Watchword is, how to open it for the first time, the tabs you'll use, and the sample data that's already loaded so you can try everything in minutes.

1 · What is Watchword?

Watchword is phishing-simulation and security-awareness training software for SMBs and MSPs. It bundles four things into one app:

It is local-first: by default it runs entirely in your browser using browser storage (localStorage), with no account and nothing sent over the network. An optional Cloud / Pro tier adds sign-in, sync, MSP entitlements, and compliance-evidence publishing.

The core flow is Train → Test → Prove. Train people with courses, test them with simulated phishing, and prove it by exporting completion and campaign records (and optionally publishing a compliance-evidence object).

2 · First run — open the app

Watchword is a static site with no build step. You open it like any web page, but it must be served over http:// (or https://), not opened as a file:// path, because the app loads its course, template, roster, and tenant data from JSON files and browsers block those reads on file://.

If you're using the hosted version

  1. Go to the Watchword site and click Open the app → (top-right, on every page).
  2. The app shell loads and lands on the Training tab.
  3. That's it — no sign-up, no credit card, nothing to install.

If you're running it locally

  1. Open a terminal in the project folder.
  2. Start any static HTTP server, e.g. python3 -m http.server 8080.
  3. Open http://localhost:8080/app/ for the app (or http://localhost:8080/ for the marketing site).
If you see "Couldn't load data". You almost certainly opened the app from a file:// path. Serve it over http instead (see above). This is the single most common first-run snag — see Troubleshooting.

3 · A tour of the tabs

The app has a top navigation bar with seven tabs. Here's what each one does and where it's documented in depth.

TabWhat it's forLearn more
MSP consoleThe tenant tree (switch between client organizations) and the cross-client risk board. The first tab in the bar.MSP multi-tenancy
TrainingThe course library. Take a course, pass the quiz, earn a certificate. This is where the app opens.Training
TemplatesBrowse the 24 phishing templates, preview a lure with its red-flag tells, and send it to the simulator.Phishing campaigns
SimulatorCompose a campaign (template + audience + cohort + schedule), run it, and read the results dashboard.Phishing campaigns
ProgramAnalytics, manager view, learner view, training-due reminders, and reports/exports — five sub-tabs.Risk scoring · Training
AI content Pro · BYO-keyGenerate a lure or a lesson with your own LLM key. Your browser calls the provider directly.Phishing campaigns
Sign in / CloudOptional sign-in, Pro feature gates, per-tenant sync, domain proof, live send, and evidence publishing.Cloud / Pro

4 · The sample data you start with

So you can explore without setting anything up, Watchword ships with realistic demo data. None of it is real and no real email is ever sent.

DatasetWhat's in it
10 coursesSpotting Phishing Emails, Passwords & MFA, Business Email Compromise & Wire Fraud, Ransomware & Safe Computing, Handling Sensitive Data (PII & PHI), Social Engineering & Pretexting, Working Securely from Anywhere, Physical Security & Clean Desk, HIPAA Privacy & Security Awareness, and Insider Risk & Removable Media. Each has lessons, a quiz, and framework tags.
24 phishing templatesAcross categories: credential-harvest, invoice/BEC, MFA-fatigue, package-delivery, HR/payroll, OAuth-consent, IT-helpdesk, plus multi-channel smishing (SMS), quishing (QR), and vishing (voice/callback). Each carries a difficulty, a sender persona, and red-flag "tells".
A demo MSP tenant treeAn MSP root ("Northwind Managed Security") over three isolated client tenants: Acme Co (6 people), Bayside Dental (4), and Fjord Logistics (5). Each client has its own roster, brand color, and pre-seeded authorized send domains.
A demo rosterPeople with department, role, manager, and new-hire flags, used by the simulator, the manager/learner views, and risk scoring.

When you first open the app the active client is the first one in the tree (Acme Co). The Training / Templates / Simulator / Program tabs all operate on whichever client is active — see MSP multi-tenancy.

5 · Where your data lives

6 · A 5-minute first session

  1. Train: open Training, click Start course on "Spotting Phishing Emails", step through the lessons, take the quiz, and view your certificate.
  2. Test: open Templates, Preview a lure to read its tells, then click Use in simulator. In Simulator, name the campaign, keep all departments checked, and click Schedule & run simulation.
  3. Prove: open Program → Reports & exports and download the Completion or Campaign CSV.