SharePoint Online: How to Create Organization Assets Library?

One of the most valuable and often underutilized resources in SharePoint is the Organization Assets Library. The SharePoint Organization Assets Library offers a centralized repository for storing and sharing brand assets, including images, documents, templates, and other media files. In this comprehensive guide, I will walk you through the ins and outs of the SharePoint Organization Assets Library, helping you understand its purpose, benefits, and how to effectively utilize it within your organization.

Introduction to SharePoint Organization Assets Library

As its name suggests, the Organizational assets library is a centralized location for storing organizational assets such as images, logos, templates, etc., to make it easier for users to access them across all sites when creating new pages and documents. It simplifies the process of maintaining a consistent brand across all company documents and presentations.

You can add multiple libraries (up to 30 as of today!) as an organization asset library, and every library you add will appear in this section (However, all organization asset libraries should be from the same site!). When you try to insert an image to any SharePoint Online page, the file picker page gives you the option to insert an image from the Web, OneDrive, upload a file, site collection, etc. Once you add an organization asset library, users can select “Your organization” in the left pane to browse the libraries you’ve specified.

sharepoint online organisation assets library

SharePoint Organization Assets Library Features

Here are some Benefits of using the Organization Assets Library in SharePoint:

Centralization of Brand Assets

Keeps all brand-related assets in one place, ensuring consistency and accessibility. By centralizing these assets in a single location, organizations can ensure consistency in their branding and messaging, while also making it easier for employees to access and utilize these resources.

Easy Access

Employees can quickly find and use the assets they need without having to search through multiple locations or rely on others to provide them with the necessary files. SharePoint’s versioning feature allows ensures everyone is using the most up-to-date versions of each asset.

Supported File Types

The Organization Assets Library supports a wide range of file types, accommodating various digital assets from images and documents to videos and presentations.

Integration with Office 365 Apps

One of the library’s strengths is its seamless integration with Office 365 apps, enhancing productivity and collaboration by providing easy access to assets directly from within the applications.

Custom Thumbnails and Metadata

Customizing thumbnails and adding metadata to your assets can greatly improve their discoverability and usability within your organization.

Control and Compliance

Provides administrators with control over the assets being used, ensuring compliance with brand guidelines. By storing all brand-related assets in one place, organizations can maintain a consistent look and feel across all their communications and materials.

How to Create an Organization Assets Library in SharePoint Online?

Prerequisites and Permissions: Ensure you have updated the PowerShell module before running these cmdlets. You need SharePoint Administrator or global admin rights on the tenant to configure the organization assets library in SharePoint.

Setting up an OAL requires SharePoint admin privileges. Here’s a step-by-step guide:

  1. Choose the Document Library: Decide which libraries will be designated as the org assets library. You can create a new document library or use existing ones on an existing site. Having a dedicated communication site for these templates is a good idea (Although you can use any type of site, such as a Team site).
  2. Upload assets to the library: Upload your common file templates and branding files, such as logos, to the library.
  3. Configure Permissions: Grant “Everyone Except External Users” read access to the library (Add this group to the visitors group, so that everyone in your organization can access the assets)
  4. Designate the Library as an OAL: This is done through the PowerShell script cmdlet Add-SPOOrgAssetsLibrary. It involves specifying the library (or libraries) and other related parameters like Thumbnail URL, Type of the library, etc.

For example, in my case, I’m going to use the “Site Assets” library from my branding site collection to ensure the corporate brand guidelines for images: https://crescent.sharepoint.com/sites/branding. I’ve uploaded an image logo.png for the Tile image in File Picker.

PowerShell Script to Create an Organization Assets Library in SharePoint

Here is how to create a new organization assets library using SharePoint Online Management Shell: Make sure you set the config parameters as per your environment:

#Config Parameter
$AdminSiteURL= "https://crescent-admin.sharepoint.com" #SharePoint Admin Center URL
$SiteURL = "https://crescent.sharepoint.com/sites/branding"
#Absolute URL of the library
$LibraryUrl = "https://crescent.sharepoint.com/sites/branding/SiteAssets"
$ThumbnailURL = "https://crescent.sharepoint.com/sites/branding/SiteAssets/Logo.png"    

#Get credentials to connect
$Credential = Get-Credential
 
#Connect to SharePoint Online services
Connect-SPOService -url $AdminSiteURL -Credential $credential

#Create Organization Asset Library
Add-SPOOrgAssetsLibrary -LibraryUrl $LibraryUrl -ThumbnailUrl $ThumbnailURL

Run the above script and click on “Yes to All” to confirm the prompts that enable the Private CDN by default. This should give you the “Document library added successfully” message on the screen. If you are enabling CDN for the first time, it takes about 15 min to complete that configuration. You can check the status of the CDN configuration in the tenant with:

Get-SPOTenantCdnOrigins -CdnType Private

If you get the “(configuration pending)” message, you must wait!

There are two types of Organization Assets libraries created: “ImageDocumentLibrary” for images like logos, photos, etc. and “OfficeTemplateLibrary” for storing office template files.

To create a template library for Office templates (Word: .dotx, Excel: .xltx, PowerPoint: .potx), use the following script:

Add-SPOOrgAssetsLibrary -LibraryURL https://crescent.sharepoint.com/sites/branding/Templates -OrgAssetType OfficeTemplateLibrary
create org assets library in sharepoint

These document templates can be used in relevant Microsoft Office applications like Word, Excel, and PowerPoint. For images library, you can specify the type as the “imagedocumentlibrary”.

PowerShell Cmdlets to Manage Org Assets Library

Here are some more cmdlets to help you manage the organization assets library in SharePoint sites:

  • To get all organization assets libraries in SharePoint Online, use:
    Get-SPOOrgAssetsLibrary
  • To update the organization assets library’s properties such as thumbnail image, use:
    Set-SPOOrgAssetsLibrary
  • To remove an organization assets library, use:
    Remove-SPOOrgAssetsLibrary

How to use the Organization Assets Library?

Once completed, you can find the organization asset libraries under the “Your Organization” tab of the file picker in a modern page (E.g., When you try to select an image from the Image web part).

organization assets library SharePoint Online

Here is the OAL in action in the PowerPoint desktop app: On the “New” menu, You’ll find a new tab for your Organization. Your PowerPoint templates should be listed there!

sharepoint online org wide templates

You can create new presentations by picking the template from the OAL.

Add Organization Assets Library SharePoint Online using PnP PowerShell

Here is the PnP PowerShell to add an organization asset library:

#Parameters
$SiteURL = "https://crescent.sharepoint.com/sites/branding"
$AssetsLibraryURL = "https://crescent.sharepoint.com/sites/branding/Assets"
$ThumbnailUrl = "https://crescent.sharepoint.com/sites/branding/Assets/Logo.png"

#Connect to SharePoint Online
Connect-PnPOnline $SiteURL -Interactive

#Add Organization Asset Library
Add-PnPOrgAssetsLibrary -LibraryUrl $AssetsLibraryURL -ThumbnailUrl $ThumbnailUrl

Other PnP PowerShell cmdlets:

Conclusion

In conclusion, creating an Organization Assets Library in SharePoint Online is a simple process that can greatly benefit your organization. By centralizing important files and documents in one location, you can improve collaboration, accessibility, and version control. The steps outlined in this tutorial show you how to create an Organization Assets Library in SharePoint Online using the SharePoint interface. Additionally, this article also showed how you could create an organization assets library by using PowerShell, which allows you to automate the process and create the library quickly. This will enable your organization to easily access and manage important assets, improving efficiency and productivity.

Salaudeen Rajack

Salaudeen Rajack - Information Technology Expert with Two-decades of hands-on experience, specializing in SharePoint, PowerShell, Microsoft 365, and related products. He has held various positions including SharePoint Architect, Administrator, Developer and consultant, has helped many organizations to implement and optimize SharePoint solutions. Known for his deep technical expertise, He's passionate about sharing the knowledge and insights to help others, through the real-world articles!

3 thoughts on “SharePoint Online: How to Create Organization Assets Library?

  • How can we use same Asset Library for Other Geo locations in Multi Geo tenant. We have enabled/Added a Org asset library in host tenant to get the organization templates in PowerPoint but users in other geo locations are unable to see the templates in their app

    Reply
  • Any idea how to get this searchable? Or, alternatively, how to add another site to the modern experience ‘select image’ dialog, not using an organization asset library?

    Reply
  • Hi. I have som questions to the above.
    – requirements to the thumbnail, can´t seem to find this anywhere, atm the site just shows empty logo like it is wrong resolution or other?

    I have run the above but on a document center and it doesn´t seem to work. so i have removed the assetslibrary (only doing the officetemplatelibrary here 😉 So my problem is that when i run the Get-SPOTenantCdnOrigins -CdnType Private | fl

    I get the following output
    */USERPHOTO.ASPX
    */SITEASSETS
    SITES/ASSETS/TEMPLATES

    I want to reset the SITES/ASSETS/TEMPLATES but how? this should also be */TEMPLATES i assume?

    Reply

Leave a Reply

Your email address will not be published. Required fields are marked *