Viewing Articulate 360 Content in SharePoint Online

May 20, 2022

Enabling Custom Scripts in SharePoint Online

Custom scripts are now disabled in SharePoint Online for security reasons by default. As a result, Articulate content with the story.html file renamed to story.aspx in the published output that previously worked with SharePoint Online might not work anymore.

If you don't need to track learners' progress or results, check out these free or low-cost options for web hosting.

If you need to use SharePoint Online, your SharePoint admin may be able to resolve this issue by following the steps below, depending on whether or not you need access immediately. (Note that we don't provide support for either workaround.)

Enabling Custom Script via the SharePoint Admin Center

If you don't need instant access, follow these steps.

  1. Go to the SharePoint admin center and sign in with your credentials.
  2. In the sidebar to the left of the page, click Settings. (If you're using the Modern admin center, click the classic settings page hyperlink at the bottom of the Settings page.)
  3. Scroll to the Custom Script section, then select the options to Allow users to run custom script on personal sites and Allow users to run custom script on self-service created sites.
  4. Click OK to save your changes. Note that this change may take up to 24 hours to appear.

Enabling Custom Script in SharePoint Online via PowerShell

For instant access, follow these steps.

  1. Open Windows PowerShell with admin privileges, then run Install-Module -Name PnP.PowerShell

    Installing PnP Module in Command Prompt
  2. Run this command: Connect-PnPOnline -Url <url> -PnPManagementShell (replace <url> with your SharePoint URL, which will then generate a code for you to insert in your SharePoint admin center.)

Creating Auth Code for PnP Module in Command Prompt

  1. Run these commands in PowerShell: (replace the URL after -Url in the first command with the link to your static site collection, such as https://companyabc.sharepoint.com/sites/StaticSite).
    (If you need help creating a SharePoint site, refer to this article from Microsoft.)
  1. Connect-PnPOnline -Url https://yourorg.sharepoint.com/sites/StaticSite 
  2. $site = Get-PnPSite 
  3. Set-PnPSite -Identity $site.URL -NoScriptSite $false

Your SharePoint site is almost ready to host HTML files! We just need to prepare the Articulate published output for upload. Here's how.

  1. In SharePoint, choose where you will locate this project. You can create a new folder or use the Documents location created by default with all SharePoint sites.
  2. Rename all the files with an .html extension in your unzipped published output folder to .aspx (keep the same file name). To do this, right-click the file and choose Rename and then replace .html with .aspx. (Most projects only need to have both the analytics-frame.html and story.html files renamed.)

Files notated with aspx change

  1. Upload the published output to your SharePoint site, then click story.aspx to launch your Articulate course. This change should take effect immediately.
55 Replies
Jennifer Brown

On your local computer, after published, change the file extensions. It has to be done before uploading to SharePoint, on your local system.

I use Windows, so if you use another operating system, how you do that may vary. I don't have to use any special applications do to it; just windows explorer to get to the files and change .HTML extensions, and launch in a browser (we use chromium based browsers, Edge or Chrome).

Bob Mongiovi

to add to this, most people don't have extensions enabled and won't see it.  While in Windows Explorer, you should have a View tab, and then there should be a checkbox for File name extensions.  make sure that is checked, and then you will see the .html extension.  You can right click on the filename and click Rename.

Jennifer Brown

To clarify, while some organizations may restrict file extension changes, users who develop with Storyline should be able to change file explorer settings to view file extensions and to edit them. But that is something that goes beyond the question. If you cannot view or edit file extensions, then whoever can upload to SharePoint must make sure the file extension changes are done prior to uploading to SharePoint.

Jennifer Brown

Here's most of what you need to know to publish Storyline to SharePoint.

 

Publishing Storyline for SharePoint

  • Authoring Tools: Storyline 3, Storyline 360, likely Rise
  • SharePoint:  SharePoint.com “Modern and On-Premise “Classic” with ability to 1) create a library, and 2) upload files
  • Operating System: Windows 10/11, with ability to edit file extensions

 

High Level Steps

  1. Publish to Web
  2. Change .HTML file extensions to .ASPX
  3. Upload to a SharePoint Document Library
  4. Use the Story.ASPX file as the target file

 

Before You Begin

  • Verify the files will be at the top of a SharePoint library and not a folder in a library
  • Ensure Storyline is up to date and save before publishing
  • Ensure “clean” publishing and do not overwrite existing folders
  • Must change the file extensions before uploading to SharePoint

 

Actions for Storyline Author

  1. Publish to Web (save project first, publish clean)
  2. Change any .HTML file extensions to .ASPX from File Explorer window:
    1. If file extensions are visible, slow double click and change the HTML to ASPX.
    2. Alternatively, right click and select Properties and change in Properties window
    3. Say yes to message, “If you change a file name extension, the file might become unusable. Are you sure you want to change it?”
      1. Storyline web publish only has two HTML files: Story.HTML, analytics-frame.HTML
      2. If attempting to use Rise or publishing for xAPI, search for all .HTML files
    4. Deliver output folder to whomever can upload to SharePoint if you are unable to upload yourself.

 

Storyline 3 Publish to Web Settings

Windows File Explorer window for a Storyline Output folder with markup

File Properties for Story file with HTML file extension

 

Actions for SharePoint Communications Owner/Designer/Member

This will not work for a Teams site, only a communications site.

  1. Create a document library just for the output
    1. Must have it’s own library
    2. Best practice: no spaces in library name (Pascal_Snake_Case for example)
  2. Place the contents of the output folder into the new SharePoint Library
    1. Upload as a group to avoid breaking connections
    2. Do not load the folder itself into the library
  3. Use Story.ASPX as the target file
    1. Target file may vary for other products like Rise
    2. xAPI target file may be Story.HTML or Index_lms.HTML

 

SharePoint library for a Storyline project with markup

 

 

Important Considerations

How organizations manage computers images, permissions, cloud backup/storage, and SharePoint can vary far beyond what can be covered here. Contact your support teams for assistance if you have any issues at any point.

This works for a SharePoint Communications site, what most people think of as SharePoint, and not a Teams site. When testing on a Teams site, even opening up "in SharePoint" and getting to the Site Content level, creating a new library to put it in, it still won't work. It will only download the Story file, and not launch. My SharePoint Admin team, that manages our tenants and works with Microsoft directly, reached out to me to research this. We're not sure precisely why, even when we create a library, not a folder. For this to work, the Storyline output must be on a communications site, and output files must be uploaded into a Library, not in a folder. 

We just got a new version and update for Teams in our organization (March 2024) and I attempted again to get web published Storyline output to work, and it still fails.

SharePoint.com generally sets up three SharePoint groups with new sites:  Owners, Members, Visitors.  Owners can create libraries (lists, etc.). Members can usually add, edit, delete items in the libraries, etc.  Visitors can read. Everything SharePoint is highly configurable from the tenant level down to the hubs and sites, so exactly how this works in your organization may vary.  But generally an Owner will create the library, and they or Members will add the files.

If a file downloads instead of running the WBT, then you are likely launching from a folder or a team site.

If you are still using Classic SharePoint, there may be other factors that are causing issues. Because SharePoint is so highly configurable, there are may places where things can create headaches.

Publish to web only; the output has less files and doesn't include the required files to send data elsewhere. This can impact whether or not it will work on your particular SharePoint tenant. Publishing for an LMS includes more files and ones that send data. If you opt to use an LMS publishing option, note there will be more HTML files that will need to have their extensions changed.

Files cannot to be ZIP'd up on SharePoint for this to work.

Storyline 360 has an option to publish to video which means a single file and may be a suitable option.

Windows File Explorer settings and what's available to you varies, depending on Windows version, edition, and your organization's settings/policies, etc. The variations are beyond scope of these steps, so you may need to consult with your IT support. 

Changing file extensions should only be done when you know exactly what you're doing and why. So don't do this for fun for other circumstances. These are specific steps for specific circumstances and are known to work for using Storyline on SharePoint when published to web. Changing file extensions changes the default program to open it.

The file extensions must be changed prior to uploading to SharePoint. 

Cloud backups and other settings may cause issues when trying to change; again, contact your support team for assistance.

 

General Best Practices and Steps to Save You Headaches

Always ensure latest version. Storyline 3.20 still works as of the date of this comment. If using S360 or any authoring tool, always use the latest version to ensure it works with current browser technology. What files get published, how they are structured, and where they go can change over time.

Always Publish Clean. I can't stress this enough; overwriting an output folder only updates the files that it's set to publish. Any other files remain, and they may include obsolete tech or cause issues with your output in general. 

Restart your system if not daily, every other day. In the age of cloud storage, federation, and other single sign-on options, this can impact what you do as a Storyline user and as a SharePoint Admin.

Reset your browser. Both Edge and Chrome are Chromium based so they are similar. This is the new "clear cache" and "allow popups" for those of us who've been around longer than Storyline. It can resolve a wide range of seemingly random issues. 

Ensure Browser(s) are current version. Just like Storyline, outdated browsers can impact the things associated with it.

All of these can not only help avoid issues, it helps with troubleshooting and isolating root causes of issues. For example, I spent a year trying to identify causes of issues with migrating an LMS from IE11 to Edge and the root cause was Storyline build versions were not verified, and the output folders had a lot of obsolete files that were blocked. It took going into hundreds of Storyline modules on our LMS to look at all the output to discover this after working with multiple teams including Articulate (thanks, Taylor, I still remember all your help). 

 

About Me

Currently an LMS Admin and SharePoint Site Collection Owner. I've worked with Articulate Products since Articulate was a premium add-in for PowerPoint. My background includes system administration, technical support, technical documentation, Instructional design and Instructional development. I'm often a person pulled in when folks are experiencing the sticky issues. The SharePoint Administrators in my organization use me as a Subject Matter Expert for publishing this kind of content to SharePoint.