Commands › SharePoint Online
Add-SPOListDesign
Creates a new list or document library design available to users when they create a new list or document library from site contents, certain site home pages, the SharePoint home page, the Microsoft Lists app, Microsoft Teams, or Office.com.
Quick start script
# Add-SPOListDesign — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-SPOService -Url https://$org-admin.sharepoint.com
# 2. Run and inspect
Add-SPOListDesign -SiteScripts <SPOSiteScriptPipeBind[]> -Title <String> | Format-List
# 3. Export for evidence / drift tracking
Add-SPOListDesign | Export-Clixml .\SPOListDesign-$(Get-Date -Format yyyyMMdd).xmlSyntax
Add-SPOListDesign -Title <String> -SiteScripts <SPOSiteScriptPipeBind[]> [-Description <String>]
[-ThumbnailUrl <String>] [-TemplateFeatures <String[]>] [-ListColor <SPOListDesignColor>]
[-ListIcon <SPOListDesignIcon>] [<CommonParameters>]Parameters (7)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Description | String | The display description of the list or document library design. | |
| -ListColor | SPOListDesignColor | Default color associated with the list when creating the list. | |
| -ListIcon | SPOListDesignIcon | Default icon associated with the list when creating the list. | |
| -SiteScripts | SPOSiteScriptPipeBind[] | yes | An array of one or more site scripts. Each is identified by an ID. The scripts run in the order listed. |
| -TemplateFeatures | String[] | Set of features that the template comes with. It is displayed as a bulleted list when the user is looking at the template preview in the list or document library creation dialog. | |
| -ThumbnailUrl | String | The URL of a thumbnail image. If none is specified, SharePoint uses a generic image. Recommended size is 400 x 300 pixels. | |
| -Title | String | yes | The display name of the list or document library design. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.