Before you start
- Download the manifest: manifest.xml. Don't edit it — Word rejects manifests with even small mistakes.
- Check your Word version: the add-in needs Word 2016 or later on Windows/Mac (Microsoft 365 recommended), or Word on the web. On Windows it also needs Microsoft Edge WebView2, which Microsoft 365 installs automatically.
- Already have an older StyleSweep add-in installed? Remove it first — see Removing & updating below. Two versions side by side confuse Word.
- Considered the macro instead? On desktop Word the VBA plugin is more capable and much easier to install. The add-in's main purpose is Word on the web and machines where macros are blocked.
Word on the web
Easiest · office.com · also works in Word desktop opened from OneDrive/SharePoint
- Open any document at word.cloud.microsoft (or office.com).
- On the Home tab, click Add-ins (older layouts: Insert → Add-ins).
- Click More Add-ins, then the My Add-ins tab.
- Click Upload My Add-in (top-right of the dialog), browse to
manifest.xml, and click Upload. - A StyleSweep button appears on the Home tab. Click it to open the pane.
Word for Windows
Permanent · uses a "trusted catalog" — a shared folder Word checks for manifests
Desktop Word on Windows won't take a manifest file directly; it reads them from a network folder you've told it to trust. The trick is sharing a folder on your own machine so it has a network path. One-time setup, about five minutes.
Step 1 — Create and share a folder
- Create a folder for the manifest, e.g.
C:\WordAddins, and copymanifest.xmlinto it. - Right-click the folder → Properties → Sharing tab → Share…
- Your own user name is already in the list; click Share, then Done.
- Back on the Sharing tab, note the Network Path, e.g.:
Step 2 — Tell Word to trust it
- In Word: File → Options → Trust Center → Trust Center Settings… → Trusted Add-in Catalogs.
- Paste the network path into Catalog Url and click Add catalog.
- Tick the Show in Menu box next to the new entry.
- Click OK twice, then close Word completely and reopen it (this step is required).
Step 3 — Add the add-in
- Home → Add-ins → More Add-ins (older Word: Insert → My Add-ins).
- Open the Shared Folder tab.
- Select StyleSweep and click Add.
- The StyleSweep button appears on the Home tab; click it to open the pane.
Word for Mac
Permanent · drop the manifest into Word's wef folder
- Quit Word.
- In Finder, press ⌘+⇧+G (Go to Folder) and paste:
- If the
weffolder doesn't exist, go to theDocumentsfolder one level up and create a folder named exactlywef. - Copy
manifest.xmlinto it. - Start Word. Go to Insert → Add-ins → My Add-ins and click the small dropdown arrow next to "My Add-ins" — StyleSweep appears under Developer Add-ins. Click it.
- The StyleSweep button appears on the ribbon; click it to open the pane.
Installing for a whole organisation
For IT admins · the clean way to give the add-in to many people
If you administer Microsoft 365, skip sideloading entirely and use Centralized Deployment: in the Microsoft 365 admin center go to Settings → Integrated apps → Upload custom apps, upload manifest.xml, and assign it to users or groups. The add-in then appears in everyone's Word automatically (web and desktop), and you can remove or update it centrally. This also works when sideloading is disabled for end users.
Removing previous versions (and the current one)
Do this before installing a newer manifest, or to uninstall completely
Word on the web
- Home → Add-ins → More Add-ins → My Add-ins.
- Find StyleSweep, click the … menu in the corner of its tile, choose Remove.
Word for Windows
- Remove the tile: My Add-ins → Shared Folder tab → the add-in disappears from Word once its manifest is gone, so:
- Delete
manifest.xml(and any older StyleSweep manifests) from your shared folder (e.g.C:\WordAddins). - If you want to remove the whole mechanism, also delete the catalog entry under File → Options → Trust Center → Trust Center Settings → Trusted Add-in Catalogs.
- If a ghost of the old version lingers, clear Word's add-in cache: close all Office apps and delete the contents of:
(paste that into File Explorer's address bar; deleting the contents is safe — Word rebuilds the cache).
Word for Mac
- Quit Word and delete the StyleSweep
manifest.xmlfrom theweffolder (path in the Mac section above). - If an old version lingers, also clear the cache by deleting the contents of:
- Restart Word.
Troubleshooting
The StyleSweep button doesn't appear after installing
Windows: did you restart Word after adding the trusted catalog? That step is mandatory. Also check the catalog path is the network path (\\PC-NAME\folder) — a plain C:\… path won't work — and that Show in Menu is ticked.
Mac: check the folder is named exactly wef (lower case) and is inside …/Data/Documents/, then look under the dropdown arrow next to My Add-ins, not the main button.
Web: uploads sometimes only apply to the current document/session — re-upload the manifest.
The pane opens but is blank, or shows "ADD-IN ERROR"
Word couldn't load the add-in from this website. First check the site is reachable: open the task pane URL in a normal browser — if that fails, GitHub Pages may not be enabled for the repository yet, or your network/proxy is blocking github.io (common on corporate networks; ask IT to allow it).
On Windows, the add-in runs inside Microsoft Edge WebView2. It ships with Microsoft 365, but on older standalone Office installs you may need to install it from Microsoft's site.
Word says the manifest is invalid
Re-download manifest.xml and use it unmodified. Editors that "helpfully" reformat XML, add a byte-order mark, or change the encoding will break it. If you must open it, use a plain-text editor and don't save.
I updated, but Word still shows the old version
Two layers can be stale. The app (what's inside the pane) loads live from this site, so a hard refresh usually fixes it: with the pane open, right-click inside it and choose Refresh (Windows) or close and reopen the pane. The manifest (button names, icons) is cached by Word — follow the cache-clearing steps in Removing & updating for your platform.
"Upload My Add-in" is missing (web) / Shared Folder tab is empty (Windows)
Web: your organisation has disabled user sideloading — ask your admin to enable it or deploy StyleSweep via Centralized Deployment.
Windows: an empty Shared Folder tab usually means Word can't read the catalog. Test the network path by pasting it into File Explorer — if Explorer can't open it, re-share the folder. On some machines network discovery must be on (Settings → Network → Advanced sharing settings → turn on file and printer sharing for Private networks).
The buttons run but lists or tables don't come out quite right
That's a known limitation of the add-in rather than an installation problem: the Word JavaScript API can't preserve list templates or create named styles the way VBA can, so the add-in approximates. For full fidelity use the VBA plugin on desktop Word. Details: the add-in README.
Still stuck?
Open an issue with your Word version, platform, which step failed, and any error text. Screenshots help.