Manage SharePoint Embedded containers in SharePoint Admin Center

The organizations that use the SharePoint Embedded applications on their Microsoft 365 (Microsoft 365) tenants are the consuming tenants and the persona that is responsible for managing these applications on their Microsoft 365 tenancy is the consuming tenant administrator (CTA). Consuming tenant administrators can manage containers through a graphical user interface (GUI) using the SharePoint Administrator Center.

To manage SharePoint Embedded containers, CTA need to be assigned the Microsoft 365 SharePoint Embedded Administrator role. Global Administrators in Microsoft 365 have all the permissions of the SharePoint Embedded Administrator role. A global administrator can assign a user the SharePoint Embedded administrator role to act as a consuming tenant admin for SharePoint Embedded. This role is available in both Microsoft Entra and the Microsoft 365 Admin Center. For information on SharePoint Embedded admin role, see SharePoint Embedded Admin.

The following actions are supported in SharePoint Admin Center:

  1. View active containers in the tenant
  2. View deleted containers in the tenant
  3. View detailed information of a container
  4. Delete a container
  5. Restore a deleted container
  6. Permanently deleted a container

Global admin will also see "Active Containers" and "Deleted Containers" page along with Site administration pages when they sign in to SharePoint Admin Center.

Active Containers global admin

SharePoint Embedded admin will only see "Active Containers" and "Deleted Containers" page when they sign in to SharePoint Admin Center.

Active Containers SPE admin

Active Containers

The Active Containers page displays all the active containers within the tenant, providing a comprehensive overview and management capabilities. This page includes the following metadata for each container:

  1. Container name : Name of the container provided by the container owner
  2. Application name : Name of the SharePoint Embedded application the container belongs to
  3. Publisher name : The name of the organization that owns the application
  4. Storage : The total storage of the files stored in the containers
  5. Owners : Users assigned the owner role on the container
  6. Sensitivity label : Name of the label assigned to the container
  7. Created on : Date and time when the container was created

Active Container Properties

View details of a container

The detailed container view provides a deeper dive into container-specific metadata, organized under two tabs:

  1. General: This panel displays all the general metadata about a container, usage, and configuration settings.

    Container Details

  2. Membership: This panel shows the user permissions for different users associated with the container.

Important

The SharePoint Embedded platform supports four distinct roles: Owner, Manager, Writer, and Reader. The SharePoint Embedded application on your tenant may not utilize all four roles and might refer to these roles using different names.

SharePoint Embedded Membership Roles

Deleted Containers

The deleted containers page lists all containers in the tenants deleted container collection. It lists the following metadata:

  1. Container name
  2. Application name
  3. Publisher name
  4. Storage
  5. Owners
  6. Sensitivity label
  7. Created on
  8. Deleted on: Date and time when the container was deleted.

Container Deletion

Delete a container

Warning

Deleting a container may cause unexpected issues for the SharePoint Embedded application it belongs to and may interrupt the application's usage. This action should only be performed by admins when absolutely necessary.

Deleting a container can have implications on the functionality of a SharePoint Embedded app, Here are some examples of the potential issues that an application can encounter when deleting a container.

  1. Data Loss: Deleting a container removes all its content. If the SharePoint Embedded application relies on the data stored within the deleted container, the app might no longer function as expected or might lose access to critical information.
  2. Broken Links: If the SharePoint Embedded application contains links or references to the deleted container, those links become broken, leading to errors or malfunctioning features within the app.

A container can be deleted from the Active containers page for any business reason by the CTA. By default, the delete button is deactivated. On selecting a container, the delete button is activated. The CTA can then select the delete button.

Container Deletion Process

This opens a side panel that warns the user about the effect on the associated SPE application due to the deletion of a container and inform the user about the restoration policy. The CTA can at this stage either cancel the panel and go back to the active containers page or proceed further with the deleting by clicking on “Delete container”.

Container deletion selection

The selected container is successfully deleted and moved into the deleted containers page.

Deleted SPE Container

Deleted containers are permanently purged after 93 days unless there is a retention policy applied to the containers

Restore a container

A container in the deleted container collection can be restored on the Deleted containers page by selecting the corresponding containers by selecting the "Restore" link

Restore Button SPE Container

Restoration of the container happens in the background and the status of the same is displayed on the top-right corner of the page. Upon successful restoration, the container will be available in the Active Containers page.

Restored SPE Container

Permanently delete a container

Warning

Deleting a container may cause unexpected issues for the SharePoint Embedded application it belongs to and may interrupt the application's usage. This action should only be performed by admins when absolutely necessary.

The CTA can permanently delete a deleted container from the deleted container collection if they decide to.

The CTA selects the container to be permanently deleted. The “Permanently delete” button is enabled.

Permanent SPE Container deletion

Upon clicking the button, a pop-up appears. warning the CTA on the action they're performing. If sure, the CTA can proceed and select on “Delete”. Otherwise the CTA can cancel the action.

Container Deletion warning

Upon clicking Delete, the container is permanently deleted and the status of the same appears in the top-right corner of the page. Upon successful deletion, the container is permanently removed from the deleted container collection and can't be restored.

SPE Container Deleted

Coming Soon

  1. Sort containers by created date and storage
  2. Filter containers by created date, application name and publisher name
  3. Edit sensitivity label of a container
  4. Add and remove users to/from a container