Skip to content

Commit 76de901

Browse files
authored
Update site-design-overview.md
Updating article to reflect new limits and new panel ux
1 parent 3aec574 commit 76de901

File tree

1 file changed

+24
-5
lines changed

1 file changed

+24
-5
lines changed

docs/declarative-customization/site-design-overview.md

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: SharePoint site design and site script overview
33
description: Use SharePoint site scripts and site designs to provide custom configurations to apply when new sites are created.
4-
ms.date: 11/01/2018
4+
ms.date: 12/19/2018
55
---
66

77
# SharePoint site design and site script overview
@@ -43,9 +43,23 @@ Had you chosen the Team site template, it contains only one default site design
4343

4444
For more information about how you can change the default site designs, see [Customize a default site design](customize-default-site-design.md).
4545

46-
When a site design is selected, SharePoint creates the new site, and runs site scripts for the site design. The site scripts detail the work such as creating new lists or applying a theme. When the actions in the scripts are completed, SharePoint displays detailed results of those actions in a progress pane.
46+
When a site design is selected, SharePoint creates the new site, and runs site scripts for the site design. The site scripts detail the work such as creating new lists or applying a theme. These script actions are run in the background. A notification bar will be displayed, which the site creator can click to view the status of the actions being applied.
4747

48-
![Progress pane listing completed actions from a site design](images/progress-pane.png)
48+
![Notification bar showing application of script actions in progress](images/site-design-notification-bar-in-progress-state.png)
49+
50+
When the scripts are complete the notification bar message will change - allowing the site creator to either refresh the page to see the results of the applied scripts or to view the site script details.
51+
52+
![Notification bar showing application of script actions is complete](images/site-design-notification-bar-completed-state.png)
53+
54+
The site design information panel can be invoked by a site owner at any time to see what site designs have been applied to the site (and their script details) as well as to apply new or updated site designs.
55+
56+
57+
> [!NOTE]
58+
> The site design information panel started rolling out to Target Release customers in December 2018 - and will complete WW rollout in early 2019.
59+
60+
When the actions in the scripts are completed, SharePoint displays detailed results of those actions in a progress pane.
61+
62+
![Site Design Information Panel](images/site-design-information-panel-applied-site-designs.png)
4963

5064
> [!NOTE]
5165
> Site designs can now be applied to previously created modern site collections. For more information, see the [REST API](site-design-rest-api.md) and [PowerShell](site-design-powershell.md) articles.
@@ -121,13 +135,18 @@ Available actions include:
121135
- Triggering a Microsoft Flow
122136
- Installing a deployed solution from the app catalog
123137
- Setting regional settings for the site
138+
- Adding principals (users and groups) to SharePoint roles
124139
- Setting external sharing capability for the site
125140

126141
For a complete list of available actions and their parameters, see the [JSON schema](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-json-schema).
127142

128-
Site scripts can be run again on the same site after provisioning. This can only be done programmatically. Site scripts are non-destructive, so when they run again, they ensure that the site matches the configuration in the script.
143+
Site scripts can be run again on the same site after provisioning. Site scripts are non-destructive, so when they run again, they ensure that the site matches the configuration in the script.
144+
145+
For example, if the site already has a list with the same name that the site script is creating, the site script will only add missing fields to the existing list.
146+
147+
We'd previously capped the limit of site script actions to 30. This remains the limit for scripts applied synchronously using the [Invoke-SPOSiteDesign](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Invoke-SPOSiteDesign?view=sharepoint-ps) command, but based on customer feedback and support for additional actions we have bumped this limit to 300 actions (or 100,000 characters) when the scripts are applied asynchronously (either through the UI or using the [Add-SPOSiteDesignTask](https://docs.microsoft.com/en-us/powershell/module/sharepoint-online/Add-SPOSiteDesignTask?view=sharepoint-ps) command).
129148

130-
For example, if the site already has a list with the same name that the site script is creating, the site script will only add missing fields to the existing list. Also, please note that site scripts are limited to 30 cumulative actions (across one or more scripts that may be called in a site design). This includes subactions.
149+
There is also a limit of 100 site scripts and 100 site designs per tenant.
131150

132151
## Using PowerShell or REST to work with site designs and site scripts
133152

0 commit comments

Comments
 (0)