Create an organization assets library

If your organization needs to store and manage images like photos or logos centrally for all your users to use, you can specify one or more document libraries as an "organization assets library." This makes it easier for users to add these assets when they create SharePoint sites and pages.


This feature is not available for Office 365 Germany, Office 365 operated by 21Vianet (China), or Office 365 US Government plans.
You can specify up to 30 organization asset libraries for a single organization, however all of these asset libraries must reside in the same site collection. You cannot add organization asset libraries from multiple site collections.

When a user adds a web part to any modern page in SharePoint and that web part opens the file picker, the user can select "Your organization" in the left pane to browse the libraries you've specified.

Use Microsoft PowerShell to specify a library as an organization assets library

  1. Select an existing site or create a new site for the organization assets.


All organization asset libraries must be on the same site.

  1. Upload the files you want to make available to all users to a document library.

  2. Download the latest SharePoint Online Management Shell version.


    If you installed a previous version of the SharePoint Online Management Shell, go to Add or remove programs and uninstall “SharePoint Online Management Shell.”
    On the Download Center page, select your language and then click the Download button. You’ll be asked to choose between downloading a x64 and x86 .msi file. Download the x64 file if you’re running the 64-bit version of Windows or the x86 file if you’re running the 32-bit version. If you don’t know, see After the file downloads, run it and follow the steps in the Setup Wizard.

  3. Connect to SharePoint Online as a global admin or SharePoint admin in Office 365. To learn how, see Getting started with SharePoint Online Management Shell.

  4. Run the following command to designate the document library as an organization assets library:

    Add-SPOOrgAssetsLibrary -LibraryURL <String> [-ThumbnailURL <String>] 

LibraryURL is the absolute URL of the library to be designated as a central location for organization assets. ThumbnailURL is the URL for the image file that you want to appear in the card's background in the file picker; this image must be on the same site as the library. The name publicly displayed for the library will be the name of the library on the SharePoint site. Learn more about the Add-SPOOrgAssetsLibrary cmdlet

Example: Add-SPOOrgAssetsLibrary -LibraryURL -ThumbnailURL


Adding an organization assets library will enable a content delivery network (CDN) for your organization to provide fast and reliable performance for shared assets. You'll be prompted to enable CDN for each organization asset library you add. Vanity domains are currently not supported. More info about CDNs