WiscWeb - Embedding Tableau visualizations
- Limitations
- Getting started
- Embedding a visualization
- Resizing a visualization
- Accessibility and usability barriers
- Troubleshooting
- Resources/help
Limitations
Private Tableaus
Tableau visualizations that require a login cannot be embedded (permissions must be set to "public.")
Example: Visualizations from tableau.wisconsin.edu tend to be private. These will not be able to be embedded.
Responsiveness
Tableau visualizations are known to extend beyond the normal screen width of a web page, which in turn will create a need to scroll left and right to view the entire content of the page.
This will be especially noticeable in mobile and tablet browser windows and can result in usability and accessibility concerns. This issue exists through the creation of the data visualization table, and its display cannot be customized through the WiscWeb embed.
Customizations and content editing
WiscWeb will not customize Tableau displays in a child theme. Tableau content building, maintenance, and troubleshooting are not included in the service and are the responsibility of the site owners and editors.
Getting started
- Review the known accessibility barriers and note the recommendations for use
- Your visualizations can be built in the campus Tableau tool (DataViz) or at the Public Tableau site.
- Please note: Publishing workbooks to the UW-Madison Enterprise Tableau Server is currently limited to administrative units and offices that have an institution-wide service role to deliver to campus audiences. For more information, please review their policies.
Embedding a Tableau visualization in a page
-
Login to Tableau
-
Locate your data visualization
-
In the top right corner of the screen, click on the Share icon
- Copy the sharing link from the pop-up window (do not use the Embed code option as it will not work)
- Navigate to the WiscWeb page that you'd like to add the visualization to
- Paste the share link into a Text Block or the Embed Content page element
- Publish your page
Resizing your visualization
The oEmbed plugin simply places your visualization in the page. It is not a vehicle for augmenting its display. Therefore, much of the display maintenance will have to occur in Tableau. This is especially important to consider if your embedded visualization requires either vertical or horizontal scrolling. The best way to prevent this is to resize the visualization sizing (width and height) in Tableau. The box will always display as 100% width in WiscWeb.
Accessibility and usability barriers
If Tableau is used on a WiscWeb site, editors are encouraged to offer a text-only version of the page to their customers via a link at the top of the page (before the visualization) and/or to include a statement regarding who to contact for a text version of the content. Site owners are responsible for building visualizations and accommodating users that are navigating the site with screen readers.
Additionally, WiscWeb recommends the following accessibility considerations per the WCAG 2.0 AA guidelines:
- Readable font types and sizes
- Color schemes that pass contrast (high contrast colors)
Tableau documents their own recommendations for improving accessibility of data visualizations on their website:
Also, the Center for User Experience has documented accessibility information in Tableau Accessibility and Usability Information.
Troubleshooting
- It may take a moment for your page to load when a visualization is embedded on it.
- Adding multiple visualizations to a page is not recommended as it could delay page load.
- If your visualization requires users to scroll both vertically and horizontally, this is because Tableau's charts and graphs are not responsive. They will not resize to fit the window.
- Only publicly accessible visualizations can be embedded. In other words, if the average user cannot see the visualization when navigating to the Tableau URL, then they won't work.