# Teachers.guide for Microsoft Word — AppSource submission pack

Everything Microsoft Partner Center asks for, in one place. Copy each section
into the matching Partner Center field.

---

## 1. Publisher account

- Programme: **Microsoft Partner Center → Marketplace (Office Store)**
- Publisher display name: `Teachers.guide`
- Verification required: registered company name, registered address, a work
  email on the teachers.guide domain, and a contact phone number.
- Verification typically takes 3–5 working days. Nothing can be submitted until
  it clears.

## 2. Add-in identity (must not change between releases)

| Field | Value |
| --- | --- |
| Add-in ID (GUID) | `f1e76bb4-9b62-48e0-8b20-8429b1fa5384` |
| Version | `1.0.2` (increment on every resubmission) |
| Hosts | Word (Windows, Mac, Web, iPad) |
| Permission | `ReadWriteDocument` |
| Manifest URL | https://teachers.guide/office-addin/manifest.xml |
| Task pane URL | https://teachers.guide/office-addin/taskpane.html |

## 3. Required public URLs

| Partner Center field | URL |
| --- | --- |
| Privacy policy | https://teachers.guide/office/privacy |
| Terms of use / licence terms | https://teachers.guide/office/terms |
| Support | https://teachers.guide/office/support |
| Help / installation | https://teachers.guide/office |

All four must be publicly reachable over HTTPS with no sign-in wall.

## 4. Listing text

**Name (30 chars max):** Teachers.guide

**Short description (100 chars):**
> Plan, mark, adapt and explain inside Word with UK-curriculum AI built for teachers.

**Long description (3,000 chars max):**
> Teachers.guide brings UK-curriculum teaching tools directly into Microsoft Word.
> Select any text in your document — a draft lesson plan, a pupil's writing, a
> worksheet, a policy extract — and run a Teachers.guide module on it without
> leaving the page. Results are inserted at your cursor, replace your selection,
> or copy to the clipboard.
>
> Built for UK schools: UK English, UK curriculum terminology (Year groups, key
> stages, exam boards), and pedagogy grounded in evidence rather than fashion.
>
> What you can do in Word:
> - Plan lessons and sequences, and adapt existing plans.
> - Generate knowledge organisers, questions and independent work.
> - Adapt any text for reading age while keeping the ambitious outcome.
> - Draft feedback, reports and parent communication.
> - Simplify, expand or restructure text you have already written.
>
> School oversight is built in: schools control which modules are available,
> credits are pooled and tracked, and usage is visible to senior leaders.
>
> Sign in with your school access code, or with a one-off connect token from
> teachers.guide/office. A Teachers.guide account is required; schools can start
> a free trial at teachers.guide.
>
> AI outputs are a starting point, not a substitute for professional judgement —
> always review before using with pupils.

**Search keywords (up to 7):** teaching, lesson planning, marking, UK curriculum,
education, SEND, feedback

**Categories:** Education; Productivity

**Products:** Word

**Industries:** Education

## 5. Store artwork

| Asset | Spec | Status |
| --- | --- | --- |
| Store logo | 300 × 300 PNG, no rounded corners, no text | to produce |
| Small logo | 48 × 48 PNG | `icon80.png` can be downscaled |
| Screenshots | 1366 × 768 PNG, 1–5 images, real UI | to capture |
| Video | optional, YouTube/Vimeo link | optional |

Screenshot suggestions: (1) pane open beside a lesson plan, (2) module dropdown,
(3) generated output ready to insert, (4) result inserted into the document.

## 6. Validator test notes (paste into "Testing instructions")

> The add-in requires a Teachers.guide account. A test account is provided below.
>
> 1. Open Word with any document (a blank document is fine).
> 2. Home ribbon → **Teachers.guide** to open the task pane.
> 3. Sign in using the school access code: `<TEST_SCHOOL_CODE>`
>    (alternative: paste the connect token `<TEST_CONNECT_TOKEN>` via
>    "Have a connect token instead?").
> 4. On a blank document, type any sentence directly into the pane's text box —
>    no document selection is required — then choose a module and press **Run**.
> 5. Wait for the result, then press **Insert at cursor**; the text is written
>    into the document. **Replace selection** overwrites the current selection.
> 6. **Copy result** places the plain-text output on the clipboard.
>
> Notes: the pane works on an empty document (it prompts you to type into the
> box). No Microsoft account data is read. The only Office permission used is
> ReadWriteDocument, for reading the selection and writing the result back.

Generate `<TEST_CONNECT_TOKEN>` from https://teachers.guide/office while signed
in, and use a dedicated validator account with credits available. Rotate both
after the review completes.

## 7. Data handling / security summary (for Partner Center and IT reviews)

- **Read:** the current selection only, on explicit user action. If nothing is
  selected, the visible document text (capped at 6,000 characters) is read when
  the user presses "Use selection from document".
- **Written:** only the generated result, only when the user presses Insert or
  Replace.
- **Transmitted:** submitted text, chosen module, connect token — over HTTPS to
  Teachers.guide edge functions (Supabase, EU) and then to Google Gemini for
  generation.
- **Stored on device:** connect token (Office roaming settings + local storage)
  and up to 8 recent results. Cleared on sign-out.
- **Retention server-side:** run content purged within 24 hours by an automated
  job.
- **Not collected:** Microsoft account identity, mailbox, tenant directory,
  telemetry on document activity, other open documents.
- **Not used for model training.**
- **Sub-processors:** Supabase (hosting/database), Google (Gemini API).

## 8. Pre-submission checklist

- [ ] Manifest validates (`npx office-addin-manifest validate manifest.xml`).
- [ ] `<Version>` incremented since the last submission.
- [ ] GUID unchanged.
- [ ] Privacy, terms and support URLs live, public, HTTPS, no login wall.
- [ ] Add-in is usable on a blank document with nothing selected.
- [ ] Pane explains what the product is before requiring sign-in.
- [ ] No broken links anywhere in the listing.
- [ ] Test account has credits and works from a clean browser session.
- [ ] Screenshots show the real, current UI.