|
1 | 1 | ---
|
2 | 2 | title: SharePoint site design and site script overview
|
3 | 3 | 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 |
5 | 5 | ---
|
6 | 6 |
|
7 | 7 | # 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
|
43 | 43 |
|
44 | 44 | For more information about how you can change the default site designs, see [Customize a default site design](customize-default-site-design.md).
|
45 | 45 |
|
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. |
47 | 47 |
|
48 |
| - |
| 48 | + |
| 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 | + |
| 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 | + |
49 | 63 |
|
50 | 64 | > [!NOTE]
|
51 | 65 | > 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:
|
121 | 135 | - Triggering a Microsoft Flow
|
122 | 136 | - Installing a deployed solution from the app catalog
|
123 | 137 | - Setting regional settings for the site
|
| 138 | +- Adding principals (users and groups) to SharePoint roles |
124 | 139 | - Setting external sharing capability for the site
|
125 | 140 |
|
126 | 141 | 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).
|
127 | 142 |
|
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). |
129 | 148 |
|
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. |
131 | 150 |
|
132 | 151 | ## Using PowerShell or REST to work with site designs and site scripts
|
133 | 152 |
|
|
0 commit comments