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.

Diagram that shows the process of getting content from folders to a SharePoint list into Viva Learning.

Viva Learning supports the following document types:

  • Word, PowerPoint, Excel, PDF
  • Audio (.m4a, .mp3)
  • Video (.mov, .mp4, .avi)
  • Linked objects

For more information, see SharePoint limits.


You can use either a Modern or Classic SharePoint site. You can choose whether to use an existing site or create a new SharePoint site based on your organization's needs.


Ensure that the SharePoint site is a communication site. This functionality isn't compatible with team sites.

Learning Service

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, appear in the Learning Service within 24 hours.

Configure SharePoint as a source


You must be a Microsoft 365 global administrator or knowledge admin to perform these tasks.

  1. Open Viva Learning App in Teams or go to the Viva Learning web app

  2. Go to the Admin tab in Viva Learning and select Manage Providers on the left menu. Select Add Provider.

  3. Select SharePoint from the Provider list and select Next.

  4. 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, wait 1 hour after site creation to add it here. You must also be the owner of the SharePoint site.

  5. If your organization uses Microsoft 365 Multi-geo, find your region or country at Microsoft 365 Multi-geo availability. The Viva Learning panel also shows this information.

  6. Update the display name in configuration flow. The display name is the organization or tenant name by default.


    Only the owner of the added site URL can update the display name.


    Display names for already ingested learning objects update after 24 hours.

    Once configured, configured providers list SharePoint immediately. You can track the sync status and export sync logs.

    A SharePoint list is created automatically within the provided SharePoint site.

  7. In the left navigation of the SharePoint site, select Site contents > Learning App Content Repository.

  8. On the Learning App Content Repository page, populate the SharePoint list with URLs to the learning content folders. Read Folder URL document library curation for details about how to create the content folders.

    1. Select New to view the New item panel.

    2. 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.

      New item panel in SharePoint showing the Title and Folder URL fields.

    3. The Learning App Content Repository page is updated with the new learning content.

      Learning Content Repository page in SharePoint showing the updated information.

      If you encounter issues with content, refer to the export log file for a detailed summary of successful and failed content ingestion.


To allow for broader access to the Learning App Content Repository, a link to the list is soon available in the Viva Learning interface where users can request access and ultimately help populate the list. Site owners and global administrators are able to grant access to the list. Access is specific to the list only and doesn't apply to the site where the list is stored. For more information, see Provide your own organization's content later in this article.


Viva Learning ingests up to 1000 items and files as learning objects.

Folder URL document library curation

Create a folder to store learning content for your organization.

  1. Go to your Documents library and select + New and choose Folder.

  2. Enter a folder name.

  3. Select Create. The folder displays in your document library.

  4. Upload files that you want to publish as learning content in this folder. Apply Microsoft 365 permissions to the folders that contain learning objects and to any items within the folders that have unique permissions. Learn how to use permissions for learning content. ​

  5. To get the folder URL, choose the folder and select Copy link.


Users are able to view content in Viva Learning with the correct permissions. See Configure permissions for SharePoint content for information.

Add linked objects

Add links to both internal content from SharePoint and external content from sites such as YouTube or Vimeo that Viva Learning includes.


When users access the content from Viva Learning, they'll be taken to the URL of the content in their browser.


A Viva Suite or Viva Learning license is required to access linked objects in Viva Learning. Without a license, you can discover linked objects in Viva Learning, but can't consume them.

  1. In your folder, select New and then choose Link.

    Screenshot of the documents library with New and Link selected.

  2. Add the URL and choose a name.

    Screenshot of the new link pane with a URL and name filled in.

  3. Select Create.

    • The link appears in your document library with the name you selected.

      Screenshot of the documents library with a new file called Azure.url.

    • The linked object will show up in the Viva Learning app.


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.

Improve overall discovery and search relevance of the content by adding columns for description, thumbnail URL, duration, author, and tags.

If a description column is already present, you can delete it and add a new one by following the steps to add a metadata field.

To add a metadata field, follow these steps:


You'll need to use the column names exactly as they're provided here for the metadata to populate the field. Adding metadata is optional, but if configured incorrectly, the learning objects and any changes to those objects won't appear.

  1. Select the folder from your learning content repository.

  2. From the Documents page, select Add column.

    Screenshot of the Documents page with Add column selected.

To add a description column to the document library page, follow these steps:

  1. Follow the initial steps to create a column.
  2. Choose Multiple lines of text.
  3. Name the column ContentDescription.
  4. Add custom descriptions for each item. If no description is supplied, Viva Learning provides a default message that highlights the content as being from your own SharePoint library.

Add the content title:

  1. Follow the initial steps to create a column.
  2. Choose Multiple lines of text.
  3. Name the column ContentTitle.
  4. Add custom title for each item. If no title is supplied, Viva Learning picks the file name as the title.

Add the content format:

  1. Follow the initial steps to create a column.
  2. Choose Multiple lines of text.
  3. Name the column ContentFormat.
  4. Add format for each item. If no format is supplied, Viva Learning picks the file type from the file extension like xlsx, docx, and so on.

Provide a thumbnail image:


Only public URLs work for this process.

  1. Follow the initial steps to create a column.
  2. Choose Hyperlink.
  3. Name the column ThumbnailWebUrl.
  4. Add the URLs for each item.

Add the duration of the content:

  1. Follow the initial steps to create a column.
  2. Choose Number.
  3. Name the column ContentDuration.
  4. Provide the duration of the content in seconds.

Add tags:

  1. Follow the initial steps to create a column.

  2. Choose Managed metadata.

  3. Name the column SkillTags.

  4. Select More options.

  5. Toggle to allow multiple values.

    Screenshot of the toggle to allow multiple values

  6. Choose to use a predefined term set or a customized term set.

Learn more about how to create a Managed Metadata column.

Add the author:

  1. Follow the initial steps to create a column.
  2. Choose Multiple lines of text.
  3. Name the column ContentAuthor.
  4. Add the author or authors of the content.

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 learning content in Viva Learning.

  1. In Viva Learning, select the ellipses (...), and then select Settings.

  2. Under Settings, select Permissions.

  3. Select Check access to connect to your organization's centralized library.

Delete content

  1. Select the content you wish to remove from your Learning App Content Repository.

  2. Choose Delete on the command bar, or select the ellipses and then select Delete.


Viva Learning takes approximately 24 hours to remove content you delete from the Learning App Content Repository.


Microsoft 365 Multi-geo is designed to meet data residency requirements.

The site URL provided by the knowledge admin where the Learning App Content Repository resides needs to belong to the central location where your Microsoft 365 subscription was originally provisioned.

Linked folders linked in the repository must also belong to the central location. This restriction conforms to data residency requirements.

If you encounter issues with content, refer to the Manage Providers Configuration export log for detailed summaries of successful and failed content ingestions.

For more information, see Multi-geo capabilities in SharePoint Online.

Next steps

Add learning management systems for Viva Learning or Add other content providers for Microsoft Viva Learning