Narrated Text in Visio for Accessibility

One of the ways that Visio supports accessibility is to provide text that is read out by a screen reader, such as Windows Narrator or JAWS. This Alt Text can be set using Format Shape / Size & Properties tab using the Title and Description text boxes. The Title is the initial text that is read out when a shape is attentioned, and the Description will only read out if the user pauses. The Description text box only allows 255 characters to be entered and displayed, but this is not actually the limit!



The Alt Text / Description text box only displays 255 characters and it will not allow more than 255 characters to be typed in.
However, it can hold much, much more than that, but these need to be pushed into the User.visAltDescription cell with code or by a ShapeSheet formula.

In this example, I am using the ScreenTip dialog to enter more than 255 characters, which is then stored in the Comment cell. Normally, I would enter a formula such as the following in to User.visAltDescription to pull the value in:


However, this does not look good for this particular cell because the Alt Text panel displays the formula rather than the actual text. This is confusing to the Visio user, but the screen reader still narrates the correct words.



Therefore, I prefer to push the text into the User.visAltDescription cell with a formula like the following in another User-defined Cell:


Note that only the first 255 characters are displayed in the Description panel, but it looks better than seeing just the formula.


The screen reader still gets all of the text, and not just the first 255 characters.

Accessibility support for Visio

NB At the time of writing this article, Windows Narrator fails to read out the Alt Text / Description in Visio Online, but JAWS does. I am assured that Microsoft will fix this….


One Response to “Narrated Text in Visio for Accessibility”

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.


O365 and SharePoint

Simplify Tasks

Want to learn the simple way?

Paul Turley's SQL Server BI Blog

sharing my experiences with the Microsoft data platform, SQL Server BI, Data Modeling, SSAS Design, Power Pivot, Power BI, SSRS Advanced Design, Power BI, Dashboards & Visualization since 2009

John Goldsmith's visLog

be smart, be clear, be visual ...

Mo's blog

Personal views on Dynamics 365 for Operations and Technical Architecture.

Chris Webb's BI Blog

Microsoft Power BI, Analysis Services, MDX, DAX, M, Power Pivot and Power Query

Azure Solutions for Office 365, and more...

Rob Fahrni



Life with Visio and other Microsoft Toys!

Nilsandrey's Weblog

Just another weblog

Things that Should be Easy

Every so often (too often in the IT industry) I encounter things that should have been very easy to do but turned out to be far too complicated. My favorite topics include SharePoint, .Net development, and software architecture, especially distributed systems.

Visio Guy

Smart graphics for visual people

%d bloggers like this: