Embed Content in Biz Reviews with iframes

Overview

WorkBoard Biz Reviews allow users to embed external web content like documents, videos, and interactive media using our iframe tray. For example, a web-hosted PowerPoint presentation, an online dashboard (Power BI) or web video (YouTube).

Embed Content with iframes

From any WorkBoard Biz Review:

  1. Select the Pencil icon 2021-09-24_14-19-06.png the top of the Biz Review. 
  2. Select Add content.
  3. Select IFrame from the drop down menu.
    2021-09-24_14-21-24.png

  4. Provide a Name for your iframe. 
  5. Paste or enter the iframe HTML, or the embed URL without the HTML. WorkBoard will validate and reformat the provided content to ensure it’s presented cleanly and safely.2020-06-12_09-11-52.png
  6. Select Save. 

How Do I Get the Embed HTML/URL for My Content?

In most cases, you’ll need to get an “Embed URL” from your application, rather than copying the URL from the browser’s location bar or using a Share URL. 

Some potential blockers in embedding content include:

  • The configuration of different applications and how they allow content to be embedded in a remote iframe.
  • Browser rules regarding embedding content into iframes.
  • Local IT policies.
  • Vendors and websites may deny embedding their site as an iframe. 

Example: You’ll need to choose Share | Embed and follow the prompts to get the embeddable iframe HTML for PowerPoint. WorkBoard will follow the configurations you set (such as active range or which slide to show) and remove unnecessary options from the iframe HTML.

Vendor-provided documentation on generating Embed URLs from common sources (published by the software vendor):

  1. Microsoft OneDrive
  2. Microsoft PowerBI
  3. Microsoft PowerPoint
  4. Google Docs, Sheets & Slides
  5. Tableau
    • See this article for more information on embedding Tableau Vizzes in Biz Review iframe Trays.

Embed Google Slides from Presentation

To embed Google Slides as an iframe: 

  1. Access a Google Slides presentation
  2. Choose File
  3. Select Publish to the Web
  4. Select Embed
  5. Copy the URL and embed as an iframe

mceclip1.png

Note: Google Slides defaults to include some optional parameters that force the slide to advance automatically (default is 3 seconds).

If you'd like your content to remain on a specific slide until you advance it manually, you can delete the optional parameters portion from the iframe link in the following format: start=false&loop=false&delayms=3000

mceclip2.png

Start Google Slide from a Specific Slide 

  1. Access a Google Slides presentation
  2. Select intended slide
  3. Copy the URL link
  4. Enter the corresponding doc id and slide id into the link structure
    1. https://docs.google.com/presentation/d/[doc_id]/embed?slide=id.[slide_id]
      mceclip0.png
  5. Embed the URL as an iframe

Frequently Asked Questions

What’s an iframe?

iframe HTML starts with <iframe src=... and ends with </iframe> and instructs the browser to embed content on a page while limiting interaction between the page and the embedded content.  

How does WorkBoard ensure iframe security?

iframes are already “safe,” but WorkBoard further sanitizes any HTML provided to prevent malicious activity within a Biz Review. WorkBoard removes any iframe attributes that might allow communication between the iframe and the parent window. Formatting attributes (such as height and width) are removed since these attributes are controlled by the Biz Report. The iframe HTML may look different, but it should function the same way.

Why might WorkBoard alter the provided iframe link?

The rewritten iframe HTML contains an attribute that may be unfamiliar, aria-label. This is an accessibility attribute that lets screen readers communicate what’s contained in the iframe. This is optional and reverts to the name of the iframe if  is missing or left blank.

Additional Resources on iframes

    1. Mozilla iframe Web Docs - Frame Ancestor
Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request