← StyleSweep

Installing the task-pane add-in

The StyleSweep add-in is a web app that Word loads from this site. Installing it means giving Word its manifest file — a small XML file that tells Word where the add-in lives. On Word on the web that takes one minute; on desktop Word it's fiddlier, so every step is written out below.

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

  1. Open any document at word.cloud.microsoft (or office.com).
  2. On the Home tab, click Add-ins (older layouts: Insert → Add-ins).
  3. Click More Add-ins, then the My Add-ins tab.
  4. Click Upload My Add-in (top-right of the dialog), browse to manifest.xml, and click Upload.
  5. A StyleSweep button appears on the Home tab. Click it to open the pane.
No "Upload My Add-in" option? Your Microsoft 365 administrator has disabled add-in sideloading for your account. Ask them to allow it, or to deploy StyleSweep centrally — see Whole organisation.
Note: uploads on the web are per-browser-session in some configurations — if the button disappears after a few days, just upload the manifest again, or use the desktop install below for something permanent.

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

  1. Create a folder for the manifest, e.g. C:\WordAddins, and copy manifest.xml into it.
  2. Right-click the folder → Properties → Sharing tab → Share…
  3. Your own user name is already in the list; click Share, then Done.
  4. Back on the Sharing tab, note the Network Path, e.g.:
\\YOUR-PC-NAME\WordAddins

Step 2 — Tell Word to trust it

  1. In Word: File → Options → Trust Center → Trust Center Settings… → Trusted Add-in Catalogs.
  2. Paste the network path into Catalog Url and click Add catalog.
  3. Tick the Show in Menu box next to the new entry.
  4. Click OK twice, then close Word completely and reopen it (this step is required).

Step 3 — Add the add-in

  1. Home → Add-ins → More Add-ins (older Word: Insert → My Add-ins).
  2. Open the Shared Folder tab.
  3. Select StyleSweep and click Add.
  4. The StyleSweep button appears on the Home tab; click it to open the pane.
Updating later: because the add-in itself is loaded live from this website, you normally never reinstall anything — new versions arrive automatically. You'd only replace the manifest in your shared folder if a future release says the manifest itself changed.

Word for Mac

Permanent · drop the manifest into Word's wef folder

  1. Quit Word.
  2. In Finder, press ++G (Go to Folder) and paste:
~/Library/Containers/com.microsoft.Word/Data/Documents/wef
  1. If the wef folder doesn't exist, go to the Documents folder one level up and create a folder named exactly wef.
  2. Copy manifest.xml into it.
  3. 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.
  4. The StyleSweep button appears on the ribbon; click it to open the pane.
Can't see the Library folder? It's hidden by default — the ++G path above works regardless. Or in Finder hold while opening the Go menu.

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

  1. Home → Add-ins → More Add-ins → My Add-ins.
  2. Find StyleSweep, click the menu in the corner of its tile, choose Remove.

Word for Windows

  1. Remove the tile: My Add-ins → Shared Folder tab → the add-in disappears from Word once its manifest is gone, so:
  2. Delete manifest.xml (and any older StyleSweep manifests) from your shared folder (e.g. C:\WordAddins).
  3. 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.
  4. If a ghost of the old version lingers, clear Word's add-in cache: close all Office apps and delete the contents of:
%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

(paste that into File Explorer's address bar; deleting the contents is safe — Word rebuilds the cache).

Word for Mac

  1. Quit Word and delete the StyleSweep manifest.xml from the wef folder (path in the Mac section above).
  2. If an old version lingers, also clear the cache by deleting the contents of:
~/Library/Containers/com.microsoft.Word/Data/Library/Caches/
  1. Restart Word.
Why removal matters when updating: Word identifies add-ins by the ID inside the manifest. Installing a new manifest alongside an old one with the same ID — or an old cached copy — can make Word show the stale version. Clean out the old manifest (and the cache if needed) first, then install the new one.

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.