Get started with Copilot in SharePoint (preview)

Copilot in SharePoint helps you do more with your content. Ask questions, run workflows, and create SharePoint sites, pages, lists, libraries, interactive reports, and Office files using natural language. Starting in mid-June 2026, these capabilities roll out as an opt-out preview and become available automatically to all users with a Microsoft 365 Copilot license.

Prerequisites

To use Copilot in SharePoint during the preview:

1. Microsoft 365 Copilot license: Users must have an active Microsoft 365 Copilot license. Copilot in SharePoint is included with this license during preview and at General Availability, at no additional cost.

2. No opt-in step is required. Copilot in SharePoint is on by default for licensed users when the opt-out preview reaches your tenant. To control availability, see Manage availability of Copilot in SharePoint.

Manage availability of Copilot in SharePoint

During preview, availability is controlled using PowerShell. You can opt out tenant-wide or for specific sites.

You use the existing KnowledgeAgent parameters in Set-SPOTenant to manage availability across all sites, selectively include sites, or selectively exclude sites.

For multi-geo tenants, the PowerShell script must be run in each geo.

The enablement process will change for general availability.

Use the SharePoint Online Management Shell version 16.0.26615.12013 or later to manage access to Copilot in SharePoint for users with Copilot licenses. For setup instructions, see Get started with SharePoint Online Management Shell.

If you already have the SharePoint Online Management Shell installed, make sure you're running the latest version by running the following command in administrative mode: Update-Module -Name Microsoft.Online.SharePoint.PowerShell.

To resolve versioning errors

If you get the following error, it might indicate that you have multiple or conflicting versions of the SharePoint Online Management Shell installed:

Set-SPOTenant : A parameter cannot be found that matches parameter name 'KnowledgeAgentScope'

To resolve the issue, follow these steps:

1. Remove the conflicting SharePoint modules by opening Add or remove programs, and searching for SharePoint. Uninstall any SharePoint admin modules you find.

2. Check the installed modules by running the following command:

   Get-Module -Name *SharePoint* -ListAvailable

   If multiple versions are listed, remove them using:

   Uninstall-Module -Name <ModuleName>

3. Manually delete the remaining modules. If you encounter exceptions during uninstall, use this command to locate the module path:

   (Get-Module -Name *SharePoint* -ListAvailable).Path

   Navigate to the parent folder and manually delete it.

4. Restart PowerShell. Close the terminal and reopen it to clear any modules loaded in memory.

5. Repeat cleanup. Repeat steps 2 and 3 until no SharePoint Online PowerShell modules remain.

6. To install the latest SharePoint Online PowerShell module, run:

   Install-Module -Name Microsoft.Online.SharePoint.PowerShell

   Note

   To verify the installed version, use the following command:

   (Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable).Version

   If multiple versions appear, repeat the previous cleanup steps.

Manage availability for specific sites

KnowledgeAgentScope

• Description: KnowledgeAgentScope allows administrators to control which SharePoint sites Copilot in SharePoint is available on.

• Valid values:

  • AllSites: Copilot in SharePoint is available on all sites.
  • IncludeSelectedSites: Copilot in SharePoint is available only on sites specified in KnowledgeAgentSelectedSitesList.
  • ExcludeSelectedSites: Copilot in SharePoint is available on all sites except those specified in KnowledgeAgentSelectedSitesList.
  • NoSites: Copilot in SharePoint isn't available on any sites. (This is the default value.)

• Note: Requires Microsoft 365 Copilot license.

KnowledgeAgentSelectedSitesList

• Description: KnowledgeAgentSelectedSitesList allows administrators to pass a list of SharePoint site URLs to include or exclude from Copilot in SharePoint.

• When KnowledgeAgentScope = ExcludeSelectedSites: the list is treated as sites to EXCLUDE (site opt-out list).

  • When KnowledgeAgentScope = IncludeSelectedSites: the list is treated as sites to INCLUDE (site opt-in list).

• By default, this overwrites any existing list with the provided list.

• This parameter can only be called when KnowledgeAgentScope is set to IncludeSelectedSites or ExcludeSelectedSites.

• The list of site URLs can't exceed 100 items.

• Note: Requires Microsoft 365 Copilot license.

KnowledgeAgentSelectedSitesListOperation

• Description: KnowledgeAgentSelectedSitesListOperation specifies the operation to perform on the current sites list.

• Valid values:

  • Overwrite: Overwrite the existing sites list (default).
  • Append: Append the input list of sites to the existing sites list.
  • Remove: Remove the input list of sites from the existing sites list.

• Note: Calling this parameter without KnowledgeAgentSelectedSitesList has no effect.

Examples

Make Copilot in SharePoint available on all sites

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Make Copilot in SharePoint available for all sites in the tenant
Set-SPOTenant -KnowledgeAgentScope AllSites

# Verify the configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope

Make Copilot in SharePoint available on specified sites only

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Make available only on the included sites
Set-SPOTenant -KnowledgeAgentScope IncludeSelectedSites

# Specify sites to include (initial inclusion list)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site5", "https://yourtenant.sharepoint.com/sites/site7")

# Add additional sites to the existing inclusion list (if needed)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site3") -KnowledgeAgentSelectedSitesListOperation Append

# Verify the inclusion configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope, KnowledgeAgentSelectedSitesList

Opt out specific sites (available on all sites except those listed)

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Make available on all sites except selected sites
Set-SPOTenant -KnowledgeAgentScope ExcludeSelectedSites

# Specify sites to exclude (initial exclusion list)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site1", "https://yourtenant.sharepoint.com/sites/site2")

# Add additional sites to the existing exclusion list (if needed)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site3") -KnowledgeAgentSelectedSitesListOperation Append

# Verify the exclusion configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope, KnowledgeAgentSelectedSitesList

Turn off Copilot in SharePoint for the tenant

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Turn off Copilot in SharePoint for all sites
Set-SPOTenant -KnowledgeAgentScope NoSites

# Verify it is turned off
Get-SPOTenant | Select-Object KnowledgeAgentScope

Other controls

Site AI settings

The Site AI settings panel lets site owners manage how users interact with AI on their site, including Copilot in SharePoint. Owners can choose which agent opens from the Agent icon, either Copilot in SharePoint or a custom agent. They can also hide the Copilot button on site pages for site visitors only.

Restricted Content Discovery

Restricted Content Discovery is an existing setting that is respected. If it's enabled on a site, Copilot in SharePoint and AI actions won't appear on that site. This applies regardless of your Copilot in SharePoint availability settings.

Language support

Copilot in SharePoint supports only the languages that appear in both the SharePoint Online supported language list and the Microsoft 365 Copilot supported language list.

• Languages supported by SharePoint
• Languages supported by Microsoft 365 Copilot

Models

Copilot in SharePoint currently runs on a Microsoft-managed reasoning model from OpenAI. Microsoft selects and manages the model, and the specific model may change over time as the service adopts newer models. No model configuration is required to use Copilot in SharePoint.