Sharing, permissions and access
General

How shareable links work in OneDrive and SharePoint in Microsoft 365 - SharePoint in Microsoft 365

In brief

The article now distinguishes direct access from link-based sharing and explains hero links, audience scopes, forwarding, authentication, and access through search or Copilot. It also updates diagrams, links, and metadata.

What SharePoint admins need to know

Administrators have clearer guidance for evaluating how sharing scopes affect internal, guest, and anonymous access. No administrator action is stated.

Summaries are generated from the documentation change itself.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

How shareable links work in OneDrive and SharePoint in Microsoft 365 - SharePoint in Microsoft 365 | Microsoft Learn

When a user sharesSharing links determine who can open a file or folder in Microsoft 365,when they receive its link and what they can do with the item. In OneDrive and SharePoint, each item has one hero link. A hero link allows users to share a single link for an item, then change the audience and permissions for that link without needing to create a shareable linknew URL.

Sharing with permissionsdirect access and links

Users can share an item with specific people or security groups through Add people. This action grants direct access to the item. There are three primaryThe item can appear in search results and is accessible through Copilot for selected users and security group members, subject to their permissions.

To share beyond a named set of recipients, users can change who the hero link types:works for under File link settings. A item has one hero link. Two people copying the hero link from the same item get the same link. Links shared by email or copied from the browser address bar work the same way for access, although the URLs might look different.

  • "Anyone" links
  • "People in your

    Hero link audience scope

    The audience scope determines who can use the hero link. Available scopes depend on the organization" links

  • "Specific people" links

It's important for everyone to understand how sharing links work and which ones to use to maintain data security. This article describes different types of sharing links and includes links to more resources.policies.

"Anyone" links

Anyone links give access

Only people added to the item to anyonefile have access

At this scope, the link works for people who hasalready have access, such as through a direct permission, a group, or the link. People using an parent folder or site. It grants no additional access.

This scope is the usual starting point. The default can differ based on site settings and the parent folder.

Anyone with the link

Anyone who receives the link don't have to authenticate,can use it without signing in, including people outside the organization. Anyone can forward the link, and their accessanonymous use can't be audited.audited to a named user.

Diagram showing how anyone links can be passed from user to user.Screenshot of a diagram showing how an Anyone with the link sharing link can be passed from user to user.

An Anyone link is a transferable, revocable secret key.

  • It's transferable because it can be forwarded to others.
  • It's revocable because you can revoke access for everyone who used the link by deleting it.
  • It's secret because it can't be guessed or derived.

The only way to get access is to get the link, and the only way to get the link is for somebody to give it to you. Anyone links can't be used with files in a Microsoft Teams shared channel site.

Creating an Anyone linkSelecting this scope doesn't make the associated content appear in search resultsglobally searchable or make it accessible through Copilot. It also doesn't immediatelyCopilot, or grant access to the content to everyone. An Anyone linkA person must be activated by clickingreceive and redeem the link (redemption)by selecting it before the shared content becomes searchable by the person who has the link.for them.

"

People in your organization" links

with the link

People in your organization links work onlyThe link works for people insidewho sign in as members of your Microsoft 365 organization.directory. They don't work for guests in the directory, only members.

Diagram showing how people in my organization links can be passed from user to user inside the company.

Like an anyone link, a People in my organization link is a transferable, revocable secret key. These links only work for people who are inside your Microsoft 365 organization. When somebody opens a People in my organization link, they needcan forward it to be authenticated as a member in your directory. If they're not currently signed in, they're prompted to sign in.

Creating a People in your organization link doesn't make the associated file or folder appear in search results or makeother members, but it accessible through Copilot. It also doesn't grant access to everyone within the organization. Creating this link doesn't provide organizational-wide access to the content. For individuals to access the file or folder, they must possess the link, and it needs to be activated through redemption (clicking it). A user redeems the link by selecting it.

If you send the link from the SharePoint or OneDrive Web UI, or by using email in Outlook or a chat message in Microsoft Teams, you automatically redeem it for individual recipients, up to a limit of 100. This feature isn't supported for group recipients, or for messages posted in Microsoft Teams channels. The link doesn't work for guests or other people outside yourthe organization.

Screenshot of a diagram showing how a People in your organization with the link sharing link can be passed from user to user inside the company.

Selecting this scope doesn't grant organization-wide access or make the item available in search or Copilot for everyone in the organization. Access through the link is established when a recipient redeems it. Microsoft 365 experiences such as SharePoint, OneDrive, Outlook, or Microsoft Teams might redeem the link automatically for recipients.

Link permissions and changes to access

While scope determines who can use the link, permission determines what they can do with the shared item. For a link with organization or anyone scope, users can choose ExpirationCan edit, Can view, Can't download, or Can review (for supported file types). The same permission options are available for direct access.

Can view is the default when a user first allows access to an item through the hero link. Administrators can't configure a different default permission for the hero link. At Only people added to the file have access, no link permission is in effect because the link grants no access of "People in your organization" linksits own.

AdministratorsChanging the scope or permission doesn't create a new URL. The change applies to links already sent, so narrowing the scope limits who can configure expiration policiesuse those links.

A user's effective access is the highest permission granted by any source: direct access, a group, the parent folder or site, the hero link, or another sharing link. For example, a user with Can edit direct access can still edit the item when the hero link grants Can view. Reducing access requires changing each source that grants a higher permission.

Default scope and folder settings

In SharePoint PowerShell, set the default audience scope for the hero link, referred to as the People in your organizationmain link, with DefaultMainLinkScope on a site. For syntax and supported values, see Set-SPOSite.

A file inherits its folder's hero link settings until the file's own hero link is explicitly set or changed. After that, the file's hero link settings are independent.

Folder sharing also grants permissions to all files and subfolders inside the folder that the sharer has access to. Owners can block those automatic permission updates for an item. This setting is separate from setting that item's hero link audience.

Additional sharing links

Users can create extra links in SharePoint and OneDrive. When an expiration policy is enabled, newly created links getfor specific needs, such as setting an expiration date and stop working after that date.or a password. They can name these links to identify the task or audience. The sharing dialog lists them under Other links, along with links inherited from a parent folder.

Existing Extra links can work for people in the organization, anyone with the link, or Specific people, which limits the link to named recipients inside or outside the organization. Available options depend on the organization's sharing policies.

Each extra link has its own audience and permission settings. Users can choose Can edit, Can view, Can't download, or Can review, where supported for the item and link type. Changing the hero link doesn't change or remove extra links.

Note

Links created before the hero link sharing experience continue to work and appear under Other links.

Specific-recipient sharing links

For the Specific people sharing link, the user sharing an item enters the names or email addresses of the intended recipients. Recipients must authenticate as a specified person in the link. Forwarding it doesn't grant access to someone else, and the link can be removed to stop sharing through that link.

Teams and Outlook might show People in your organizationthis chat or People in this email. These are specific-people links aren't automatically modified when an expiration policy is enabled. However, when an existing link is accessed afterscoped to the policy isrecipients in effect,that chat or email, not to everyone in the link is evaluated againstorganization.

\ No newline at end of file For users and security group members added to a specific-recipient link, the configured expiration limit using its original creation date. If the link exceeds the allowed age, it's treated as expired anditem can no longer be used to access the content.

When a sharing link expires, only the link is affected. The file or folder isn't deleted, and users who have access through other permissions can continue to access the content.

"Specific people" links

Specific people links only work for the people that users specify when they share the item.

Diagram showing how specific people links only work for the people specified.

A Specific people link is a nontransferable, revocable secret key. Specific people links don't work if they're opened by anybody other than the persons who are specified by the sender. Moreover, Specific people links make the associated file or folder appear in search results and make itbe accessible through Copilot for all user and security group members who are addedCopilot, subject to the sharing link.

Specific people links can be used to share with users in the organization and people outside the organization. In both cases, the recipient needs to authenticate as the user specified in the link.their permissions. For files in a Microsoft Teams shared channel site, Specificyou can send these links only to people links can only be sent to others in the channel. \ No newline at end of file \ No newline at end of file