Configure an Organisation Assets location for images

Please note that this is a feature summary for the following Microsoft documentation as of March 2022: https://docs.microsoft.com/en-us/sharepoint/organization-assets-library 

To configure this Microsoft 365 feature please follow the steps provided at the above link.

Configuring this feature requires use of PowerShell and SharePoint Administrator permissions.

Options when Adding Images

When adding images to modern pages, users are presented with an Image Picker which provides access to free stock images, web search, or images within the current Atlas workspace, but for many organisations it is preferred or required to use approved, branded images.

In this situation you should configure an Organisation Assets library and make it available wherever the Image Picker appears, under the tab Your organization:

You can configure multiple locations to be listed under this tab, for example:

Permissions to the assets

We recommend provisioning a dedicated 'digital assets' or 'approved org imagery' workspace to map the Microsoft Organisation Assets to. Creating a SharePoint Out Of The Box document library is the best way to store images (not the Atlas Document Library), so that these individual images do not appear as documents within Atlas Search. You can point the configuration script outlined below directly to this created document library.

To allow all users to see the libraries you add, you'll need to ensure they have Visitor permissions on them - in this case you could use the Everyone except external users group to ensure everyone has access. Otherwise you can use permissions to control visibility - for example giving users access only to specific libraries that they need to use.

Example configuration script

This script when run from a PnP PowerShell session will configure the Organisation Assets library feature pointed to the Document Library URL specified in the second paragraph:

$connection = Connect-PnPOnline -Url https://TENANTNAME-admin.sharepoint.com/ -ReturnConnection -Interactive

Add-SPOOrgAssetsLibrary -LibraryURL https://TENANTNAME.sharepoint.com/sites/ImageLibrarySite/Shared%20Documents -OrgAssetType ImageDocumentLibrary -ThumbnailURL TENANTNAME.sharepoint.com/sites/ImageLibrarySite/Shared%20Documents/ThumbnailImage.png -CdnType Private

You can run the script multiple times to add multiple libraries.

Still need help?

Please get in touch with support or your CSM for further advice or assistance.