Skip to content

Update overview.md #10578

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
ishwarit wants to merge 11 commits into
base: main
Choose a base branch
from
Draft

Update overview.md #10578

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
c9b7f56
Learn Editor: Update overview.md
ishwarit Jan 12, 2026
fbeb916
Learn Editor: Update containertypes.md
ishwarit Jan 13, 2026
e4f6b51
Learn Editor: Update office-experience.md
ishwarit Jan 14, 2026
71a8ba4
Learn Editor: Update cta.md
ishwarit Jan 14, 2026
828d0df
Learn Editor: Update ctapowershell.md
ishwarit Jan 14, 2026
4188a5a
Learn Editor: Update dev-admin.md
ishwarit Jan 14, 2026
4e516b0
Learn Editor: Update cta.md
ishwarit Jan 28, 2026
492bd2d
Learn Editor: Update cta.md
ishwarit Feb 2, 2026
7efaabf
Learn Editor: Update ctapowershell.md
ishwarit Feb 2, 2026
bc34f21
Learn Editor: Update dev-admin.md
ishwarit Feb 2, 2026
f2125c3
Merge branch 'main' into docs-editor/overview-1768211079
ishwarit Feb 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions docs/embedded/administration/consuming-tenant-admin/cta.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,8 @@ On PowerShell, the SharePoint Embedded Admin can run the following cmdlets:

1. Enumerate applications in a tenant
1. Enumerate containers of an application in a tenant
1. Enumerate containers of an application sorted basis storage
1. Enumerate archived containers of an application
1. Enumerate containers of an application sorted by storage basis storage
1. Edit the sensitivity label on a container
1. Set the sharing capability configuration on a container
Expand All @@ -51,9 +53,10 @@ For information on consuming tenant admin in [PowerShell](../consuming-tenant-ad
The SharePoint Embedded Admin can access the Active and Deleted containers page on SPAC and perform SharePoint Embedded application-level and container-level actions. This includes the following:

1. View the Active container page
1. View the Archived container page
1. View the Deleted container page
1. View the detailed information of a container
1. Soft delete, restore, and purge deleted containers
1. Archive, soft delete, reactivate, restore, and purge deleted containers

For information on consuming tenant admin in SharePoint Admin, see [container management](ctaUX.md)

Expand All @@ -67,13 +70,14 @@ To use passthrough billing SharePoint Embedded app, the SharePoint Embedded Admi

### [Meters](../billing/meters.md)

SharePoint Embedded employs a pay-as-you-go (PAYG) billing model through an Azure subscription. Billing is determined by how much data in GB you store in SharePoint Embedded, transactions used to access and modify the container and container contents, and data that is egressed from the SharePoint Embedded platform. Each of these factors contributes to the overall cost, ensuring that you only pay for the resources and services you use. You can view this usage and billing details in the [Azure Cost Management](https://ms.portal.azure.com/).
SharePoint Embedded employs a pay-as-you-go (PAYG) billing model through an Azure subscription. Billing is determined by how much data in GB you store in SharePoint Embedded in active and archived states, transactions used to access and modify the container and container contents, and data that is egressed from the SharePoint Embedded platform. Each of these factors contributes to the overall cost, ensuring that you only pay for the resources and services you use. You can view this usage and billing details in the [Azure Cost Management](https://ms.portal.azure.com/).

SharePoint Embedded has three billing meters, as shown. Refer to the [product page](https://adoption.microsoft.com/en-us/sharepoint/embedded/) for pricing details

| SharePoint Embedded Service Meters | Meter Unit |
| :--------------------------------: | :------------: |
| Storage | $/GB |
| Archived Storage | $/GB |
| API Transactions | $/Transactions |
| Egress | $/GB |

Expand Down
11 changes: 10 additions & 1 deletion docs/embedded/administration/consuming-tenant-admin/ctapowershell.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,9 @@ The following are some of the container-specific command actions currently suppo

### Container administration

- Get details of all containers of a particular SharePoint Embedded application in the tenant
- Get details of all active containers of a particular SharePoint Embedded application in the tenant
- Get details of a specific container
- Get details of all archived containers of a particular SharePoint Embedded application in the tenant
- Set the Sensitivity label of a specific container
- Soft delete a container
- Get details of all soft deleted containers
Expand Down Expand Up @@ -91,6 +92,12 @@ Get-SPOContainer -OwningApplicationId <OwningApplicationId> | FT

The `OwningApplicationId` is the ID of the SharePoint Embedded application. For more information about using this command, see [Get-SPOContainer cmdlet](/powershell/module/sharepoint-online/get-spocontainer).

Similarly, this command lists all the archived containers within the application with Id OwningApplicationId:

```powershell
Get-SPOContainer -OwningApplicationId <OwningApplicationId> -ArchiveStatus Archived | FT
```

> [!NOTE]
> To enumerate Microsoft Loop containers, use Owning App ID: **a187e399-0c36-4b98-8f04-1edc167a0996** for all the cmdlets of container administration.

Expand Down Expand Up @@ -173,6 +180,8 @@ Admins can restore a deleted container from the deleted container collection usi
Restore-SPODeletedContainer -Identity <ContainerId>
```

If the container was in archived state at the time of deletion, it gets restored to archived state again.

### Permanently delete containers

Admins can permanently delete a container from the deleted container collection if the container has no further retention policies applied to it. For more information about using this command, see [Remove-SPODeletedContainer cmdlet](/powershell/module/sharepoint-online/remove-spodeletedcontainer).
Expand Down
2 changes: 2 additions & 0 deletions docs/embedded/administration/developer-admin/dev-admin.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,8 @@ The developer administrator can change container type configuration settings usi
1. Discoverability Disabled: Controls if file items inside the container surface in other Microsoft 365 properties (MRU, etc.).
1. Sharing Restricted: Only the manager and owner can share files in the container if restricted sharing is true.

1. Is Archive Enabled: If set to true, the application can support archival of containers. Default value is false.

The following commands can be used to change the configuration settings of SharePoint Embedded applications created on the developer admin’s tenant:

```powershell
Expand Down
2 changes: 2 additions & 0 deletions docs/embedded/development/content-experiences/office-experience.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,8 @@ Office file experiences for SharePoint Embedded platform will work in a similar

Office documents from SharePoint Embedded apps can be opened for viewing and editing in Office web or in the Office application for a richer viewing and editing experience. AutoSave feature saves your files automatically as your user's work and is enabled for each Word, Excel, and PowerPoint file stored in your SharePoint Embedded Application Apps.

Documents stored in an archived container can’t be viewed or accessed. Applications must handle the archived state of the container by displaying an appropriate error message and guiding end users on the next steps to regain access, such as reactivating the container.

## View or restore a previous version of an Office document from SharePoint Embedded

Versioning is automatically enabled on each Word, Excel, and PowerPoint file stored in your SharePoint Embedded Apps, that helps your users to see what changes have been made in a file, compare different versions, or restore the version you want. This is incredibly important to your users if a mistake was made, a previous version is preferred, or in multi-user coauthoring scenarios when your users are collaborating with others and someone makes changes your users didn't want in a file.
Expand Down
37 changes: 37 additions & 0 deletions docs/embedded/getting-started/containertypes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,43 @@ Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscript
>
> If the cmdlet above fails with a SubscriptionNotRegistered error, it is because **Microsoft.Syntex** isn't registered as a resource provider in the subscription. The cmdlet sends a resource provider registration request on your behalf but it takes a few minutes to be completed. Wait 5-10 minutes and try again until the cmdlet succeeds.

1. In [Microsoft 365 admin center](https://admin.microsoft.com/), select **Setup**, and the view the **Billing and licenses** section. Select **Activate pay-as-you-go services.**

![Microsoft 365 admin center Files and Content](../images/SyntexActivatePAYGSetup.png)

1. Select **Go to Pay as you go services**.
1. Select **Apps** under **Syntex services for**, select **Apps** and **SharePoint Embedded**

![Microsoft 365 admin center SharePoint Embedded Billing setting](../images/SyntexPAYGActivateSPE.png)

> [NOTE]
The subscription configured in the Syntex services will reflect the consumption charges in the Azure billing portal.

1. [Register the container type](#registering-container-types) using the App only authentication token.

## Configuring Container Types

Developer admins can configure selected settings for SharePoint Embedded container types that have been created. The following table lists the available settings.

| Settings | Description |
|----------|----------|
| **ApplicationRedirectUrl** | Specifies the URL to which the application’s files are redirected. |
| **CopilotEmbeddedChatHosts** | Adds host URLs that are permitted to use the SharePoint Embedded application’s declarative agent experience. |
| **DiscoverabilityDisabled** | Determines whether content from a SharePoint Embedded application is visible across Microsoft 365 experiences. |
| **SharingRestricted** | Configures sharing permissions for SharePoint Embedded containers by using role-based access. Supports both open and restrictive sharing models. When restrictive sharing is set to true, only managers and owners can share files in the container.|
| **IsArchiveEnabled** | When set to True, the owning application of the container type can support archival of containers. Archive helps in saving cost of storage by moving inactively used content to cold tier. |

The [Set-SPOContainerType](/powershell/module/sharepoint-online/Set-SPOContainerType) cmdlet allows admins to update the Application Redirect URL. The [Set-SPOContainerTypeConfiguration](/powershell/module/sharepoint-online/Set-SPOContainerTypeConfiguration) cmdlet allows admins to add host URLs, set [Microsoft 365 content discoverability](../development/content-experiences/user-experiences-overview.md) and [sharing](../development/sharing-and-perm.md) settings on container types. The setting applies to all container instances of the container type.

### Example 1

```powershell
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -DiscoverabilityDisabled $false
```

Example 1 turns on discoverability for this container type. All content created within this container type will be discoverable in the Microsoft 365 experience, including on office.com, onedrive.com, recommended files, and other intelligent discovery experiences.

### Example 2
To update the billing profile for a standard container type, use the following cmdlet:

```powershell
Expand Down
2 changes: 1 addition & 1 deletion docs/embedded/overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ This includes settings from Microsoft Purview compliance, risk, and security set

Microsoft 365 customers have different entitlements related to storage, usage, and features depending on the licenses the customer has purchased.

The partition created in the consumer’s Microsoft 365 tenant by a SharePoint Embedded app doesn’t count towards other Microsoft 365 entitlements including the total amount of Microsoft SharePoint storage that can be used by your organization. Instead, the partition in the consumer’s Microsoft 365 tenant by the SharePoint Embedded app are billed separately through an Azure subscription on a pay-as-you-go metered consumption model that’s based on total storage and the number of API calls.
The partition created in the consumer’s Microsoft 365 tenant by a SharePoint Embedded app doesn’t count towards other Microsoft 365 entitlements including the total amount of Microsoft SharePoint storage that can be used by your organization. Instead, the partition in the consumer’s Microsoft 365 tenant by the SharePoint Embedded app are billed separately through an Azure subscription on a pay-as-you-go metered consumption model that’s based on total storage in active and archived state and the number of API calls.

> [!NOTE]
> Learn more about billing for SharePoint Embedded, see [Billing Meters](./administration/billing/meters.md).
Expand Down