Documentation

Enabling Search

Enabling Visio Shape Search

Visio’s Shape Search is the search box at the top of the Shapes panel. Typing anything into it does a full-text query across every open stencil’s masters: name, keywords, prompts, descriptions. When it works it’s the single fastest way to find one of 486 icons.

The catch: making Visio search reliable requires understanding which cells it actually reads and why the conventional approach of writing keywords everywhere is counterproductive. Visio-Cisco applies an empirically-derived search contract developed during the Visio-Azure investigation. But you also need Visio’s own search feature enabled to make use of it.

How the search contract works

The contract was established by running a five-variant A/B lab against Visio’s Shapes-pane search and Microsoft’s own shipped stencils. The findings differ from the intuition that “more keywords = more findable”:

Location What’s stored Why
Master/@NameU and @Name Display name Canonical name visible in the panel; must be unique within the stencil
Master/@Prompt Display name The field Visio’s My Shapes search actually matches. Stencils with empty Prompts are invisible to search, including Microsoft’s own files when copied into My Shapes
Document-level <dc:subject> / <cp:keywords> in docProps/core.xml Aggregated master names Stencil-wide index

What is deliberately NOT done: writing the group name or any repeated leading token into every master’s keywords. Experiments showed that repeating a common prefix across all masters of a stencil demotes the entire stencil from Visio’s search results. Keyword stuffing is counterproductive.

Unique Master/@NameU: duplicate names within a stencil demote the stencil entirely. The combined All-Icons stencil suffixes any cross-group name collision with ` (Group)` to guarantee uniqueness.

Unit suffix gates search: the _m / _u filename suffix is load-bearing for search, not just sizing. Visio only surfaces _m stencils when the active page is in metric units, and _u stencils when the page is in US units. A mismatch makes the stencil invisible to search entirely. Full explanation →

Verifying it works on your machine

  1. Open any Visio-Cisco stencil.
  2. Click into the search box at the top of the Shapes panel.
  3. Type anycast gateway: you should see the SD-Access Anycast Gateway icon appear.
  4. Try other queries: border node, stealthwatch, access point, fabric zone.

If nothing happens when you type, your Visio’s search index may be off, or there is a unit mismatch. The sections below cover both.

Shape Search is on by default on most Visio installs. If your search box is missing or queries return nothing across all stencils (not just this one):

Visio for Microsoft 365 (Windows)

  1. File → Options → Advanced.
  2. Scroll to Shape Search.
  3. Check Show Shape Search panel.
  4. OK.

Visio 2019 / 2021 desktop

  1. File → Options → Advanced.
  2. Find Shape search options.
  3. Ensure Enable shape search is checked, and (optionally) Search Visio.com if you also want the online catalogue.
  4. OK.

Visio for Mac

The Mac version of Visio has Shape Search built-in and visible by default in the Shapes panel. There is no toggle.

Reindexing if results are stale

Visio caches its keyword index for performance and caches search results per session. If you have just installed a fresh stencil and search results look stale or missing:

  1. File → Close the drawing.
  2. Reopen Visio.
  3. Open the stencil again: the index rebuilds on first use.

On Windows you can also force a full reindex by deleting %USERPROFILE%\AppData\Roaming\Microsoft\Visio\ShapeSearch.idx and restarting Visio.

Important: Visio caches search results per session. Always restart Visio between search experiments, otherwise a failed search result from an earlier session will persist even after the stencil is corrected or the index is rebuilt.

Known limitation: Visio’s shipped content suppresses My Shapes results

When Visio’s own built-in content (the stencils that ship with Visio) matches a search term, My Shapes results for that same term are suppressed entirely, not merely outranked. This is a Visio-side behaviour with no pipeline counter-measure. It means that common generic terms (e.g. “router”, “switch”) that also appear in Visio’s built-in Networking stencils may return only Visio’s built-in shapes when searched, hiding the Cisco stencil results.

Workaround: use more specific search terms. “Catalyst 9300”, “border node”, “Stealthwatch”, and “anycast gateway” are unique to the Cisco stencil and will not be suppressed.

Why keyword stuffing hurts more than it helps

It’s tempting to write the group name, product family, and a list of synonyms into every master’s keywords on the assumption that more data means more findable. The lab experiments showed the opposite: repeating a common leading token (e.g. “Cisco” or “SD-Access”) across every master in a stencil caused Visio to demote the entire stencil from search results. Visio appears to treat term frequency across masters as a spam signal.

Visio-Cisco therefore writes only the display name into each master’s Prompt, and relies on the display names being specific enough to match user queries. Longer display names are kept as-is rather than trimmed.

Still no results?

If you see specific Cisco icon names failing on Visio-Cisco stencils and you have confirmed your Visio search is on:

  1. Check your page measurement units match the stencil suffix: see Metric vs US units.
  2. Re-download the stencil: a truncated download can leave the keyword index incomplete.
  3. Force a Visio shape-search reindex by deleting %APPDATA%\Microsoft\Visio\ShapeSearch.idx and restarting Visio.
  4. Open an issue at github.com/xeeva/Visio-Cisco/issues with your Visio version, OS, page unit setting, and the search term that returned nothing.
hub