Add SharePoint as a content source for Microsoft Viva Learning
You can configure SharePoint as a learning content source to make your organization's own content available in Viva Learning.
Content accessible through Viva Learning is subject to terms other than the Microsoft Product Terms. Any content you add to Viva Learning, such as SharePoint-hosted content, is subject to the privacy and service terms associated with that content.
The knowledge admin (or global administrator) provides a site URL to where the Learning Service can create an empty centralized location in the form of a structured SharePoint list. This list is called the Learning App Content Repository. Your organization can use this list to house links to cross-company SharePoint folders that contain learning content. Admins are responsible for collecting and curating a list of URLs for folders. These folders should only include content that can be made available in Viva Learning.
Viva Learning supports the following document types:
- Word, PowerPoint, Excel, PDF
- Audio (.m4a)
- Video (.mov, .mp4, .avi)
For more information, see SharePoint limits.
If you're using Microsoft 365 Multi-geo, the site URL provided by the knowledge admin (where the Learning App Content Repository will be located) needs to belong to the central location where your Microsoft 365 subscription was originally provisioned. Folders linked to in the repository should also belong to the central location. Viva Learning has added this restriction to conform to data residency requirements.
Document library folder URLs can be collected from any SharePoint site in the organization. Viva Learning follows all existing content permissions. Therefore, only content for which a user has permission to access is searchable and visible within Viva Learning. Any content within these folders will be searchable, but only content to which the individual employee has permissions can be used.
Content deletion from your organization's repository is not currently supported.
To remove unintentionally surfaced content, follow these steps:
To restrict access to the document library, select the Show actions option, and then select Manage access.
Delete the original document within the document library.
For more information, see Sharing and permissions in the SharePoint modern experience.
The Learning Service uses the provided folder URLs to get metadata from all content stored in those folders. Within 24 hours of supplying the folder URL in the centralized repository, employees can search for and use your organization's content within Viva Learning. All changes to content, including updated metadata and permissions, will also be applied in the Learning Service within 24 hours.
Configure SharePoint as a source
You must be a Microsoft 365 global administrator, SharePoint administrator, or knowledge admin to perform these tasks.
To configure SharePoint as a learning content sources in for Viva Learning, follow these steps:
In the left navigation of the Microsoft 365 admin center, go to Settings > Org settings.
On the Org settings page, on the Services tab, select Viva Learning.
On the Viva Learning panel, under SharePoint, provide the site URL to the SharePoint site where you want Viva Learning to create a centralized repository. If your SharePoint site is new, you'll need to wait 1 hour after site creation to add it here. You must also be the owner of the SharePoint site.
A SharePoint list is created automatically within the provided SharePoint site.
In the left navigation of the SharePoint site, select Site contents > Learning App Content Repository.
On the Learning App Content Repository page, populate the SharePoint list with URLs to the learning content folders.
Select New to view the New item panel.
On the New item panel, in the Title field, add a directory name of your choice. In the Folder URL field, add the URL to the learning content folder. Select Save. Learn how to to create the folder URL.
The Learning App Content Repository page is updated with the new learning content.
If your organization uses Microsoft 365 Multi-geo and you try to add a link to a folder that doesn't belong to the central location, you'll get an error message. All folders need to belong to the central location.
To allow for broader access to the Learning App Content Repository, a link to the list soon will be available in the Viva Learning interface where users can request access and ultimately help populate the list. Site owners and global administrators will be required to grant access to the list. Access is specific to the list only and does not apply to the site where the list is stored. For more information, see Provide your own organization's content later in this article.
Folder URL document library curation
Create a folder to store learning content for your organization.
Go to your Documents library and select + New.
Choose Folder and enter a folder name.
Select Create. The folder will now show up in your document library.
Upload files that you want to publish as learning content in this folder.
To get the folder url, choose this folder and select Copy link.
Default metadata (such as modified date, created by, document name, content type, and organization name) is automatically pulled into Viva Learning by the Microsoft Graph API.
To improve overall discovery and search relevance of the content, we recommend adding a Description column. If there's already a description column present, you can delete it and add a new one by following the steps below.
To add a Description column to the document library page, follow these steps:
On the Documents page, select Add column.
Select the Show actions option, and then select Single line of text.
On the Create a column panel, in the Name field, add a descriptive name for the column. Select Save.
On the Documents page, in the Description column, add custom descriptions for each item. If no description is supplied, Viva Learning will provide a default message that highlights the content as being from your own SharePoint library.
Provide your own organization's content
Knowledge admins can access their organization's Learning App Content Repository in SharePoint, where they can provide references to cross-organization document libraries. Content within these libraries will be then surfaced as learning content in Viva Learning.
In Viva Learning, select the ellipses (...), and then select Settings.
Under Settings, select Permissions.
Select Check access to connect to your organization's centralized library.