Skip to content

Commit 5f1a852

Browse files
authored
Update site-design-overview.md
Added new notes to the top to reflect the new site template UX. Also updated most occurrences of the word "design" to template.
1 parent 96e0e3c commit 5f1a852

File tree

1 file changed

+27
-23
lines changed

1 file changed

+27
-23
lines changed

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

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,23 @@ localization_priority: Priority
88
# SharePoint site design and site script overview
99

1010
> [!NOTE]
11-
> Site designs and site scripts are currently only supported by SharePoint Online.
11+
> - Site designs and site scripts are currently only supported by SharePoint Online.
12+
> - In previous versions of SharePoint, site templates were called site designs but will be referred to as site templates moving forward.
13+
>- SharePoint has a new site template experience that will be available to all SharePoint user with permissions to create SharePoint sites. [Learn more about the new site template experience](https://support.microsoft.com/office/apply-and-customize-sharepoint-site-templates-39382463-0e45-4d1b-be27-0e96aeec8398?ui=en-US&rs=en-US&ad=US).
14+
>- As of today, the site template experience cannot be disabled.
15+
>- Site template version history is not currently available for the new site template experience but will be included in future iterations.
1216
13-
Use site designs and site scripts to automate provisioning new or existing modern SharePoint sites that use your own custom configurations.
17+
Use site templates and site scripts to automate provisioning new or existing modern SharePoint sites that use your own custom configurations.
1418

1519
When people in your organization create new SharePoint sites, you often need to ensure some level of consistency. For example, you may need proper branding and theming applied to each new site. You may also have detailed site provisioning scripts, such as using the PnP provisioning engine, that need to be applied each time a new site is created.
1620

17-
This article describes how you can use site designs and site scripts to provide custom configurations to apply when new sites are created.
21+
This article describes how you can use site templates and site scripts to provide custom configurations to apply when new sites are created.
1822

19-
## How site designs work
23+
## How site templates work
2024

21-
Site designs are like a template. They can be used each time a new site is created to apply a consistent set of actions. They can also be applied to existing modern sites (group-connected Team and Communication sites). Most actions typically affect the site itself, such as setting the theme or creating lists. But a site design can also include other actions, such as recording the new site URL to a log, or sending a tweet.
25+
Site templates can be used each time a new site is created to apply a consistent set of actions. They can also be applied to existing modern sites (group-connected Team and Communication sites). Most actions typically affect the site itself, such as setting the theme or creating lists. But a site template can also include other actions, such as recording the new site URL to a log, or sending a tweet.
2226

23-
You create site designs and register them in SharePoint to one of the modern template sites: the Team site or the Communication site. You can see how this works in the following steps.
27+
You create site templates and register them in SharePoint to one of the modern template sites: the Team site or the Communication site. You can see how this works in the following steps.
2428

2529
1. Go to the SharePoint start page on your developer tenant.
2630

@@ -30,36 +34,36 @@ You create site designs and register them in SharePoint to one of the modern tem
3034

3135
3. Choose **Communication site**.
3236

33-
The Communication site has a **Choose a design** box, which comes with the following site designs:
37+
The Communication site has a **Choose a design** box, which comes with the following site templates:
3438

3539
- Topic
3640
- Showcase
3741
- Blank
3842

39-
These are the default site designs. For each site design, there is a title, description, and image.
43+
These are the default site templates. For each site template, there is a title, description, and image.
4044

4145
![Default site design title, description, and image on Communication site template](images/site-designs-listed-on-communication-site-template.png)
4246

43-
Had you chosen the Team site template, it contains only one default site design named **Team site**.
47+
Had you chosen the Team site template, it contains only one default site template named **Team site**.
4448

45-
For more information about how you can change the default site designs, see [Customize a default site design](customize-default-site-design.md).
49+
For more information about how you can change the default site templates, see [Customize a default site design](customize-default-site-design.md).
4650

47-
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.
51+
When a site template 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.
4852

4953
![Notification bar showing application of script actions in progress](images/site-design-notification-bar-in-progress-state.png)
5054

5155
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.
5256

5357
![Notification bar showing application of script actions is complete](images/site-design-notification-bar-completed-state.png)
5458

55-
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.
59+
The site template information panel can be invoked by a site owner at any time to see what site templates have been applied to the site (and their script details) as well as to apply new or updated site templates.
5660

5761
When the actions in the scripts are completed, SharePoint displays detailed results of those actions in a progress pane.
5862

5963
![Site Design Information Panel](images/site-design-information-panel-applied-site-designs.png)
6064

6165
> [!NOTE]
62-
> 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.
66+
> Site templates 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.
6367
6468
## Anatomy of a site script
6569

@@ -147,11 +151,11 @@ For example, if the site already has a list with the same name that the site scr
147151

148152
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/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/powershell/module/sharepoint-online/Add-SPOSiteDesignTask?view=sharepoint-ps) command).
149153

150-
There is also a limit of 100 site scripts and 100 site designs per tenant.
154+
There is also a limit of 100 site scripts and 100 site templates per tenant.
151155

152-
## Using PowerShell or REST to work with site designs and site scripts
156+
## Using PowerShell or REST to work with site templates and site scripts
153157

154-
You can create site designs and site scripts by using PowerShell or the REST API. The following example creates a site script and a site design that uses the site script.
158+
You can create site templates and site scripts by using PowerShell or the REST API. The following example creates a site script and a site template that uses the site script.
155159

156160
<!-- The PowerShell example loads the script from a file, while the REST example has the script inline. -->
157161

@@ -244,15 +248,15 @@ In the previous example, the **Add-SPOSiteScript** cmdlet or **CreateSiteScript*
244248
The **WebTemplate** parameter set to the value 64 indicates registering this site design with the Team site template. If you have disabled modern Group creation, then publish your site designs using WebTemplate 1 so that they display for the "Group-less" Team site template. The value 68 would indicate registering with the Communication site template. The **Title** and **Description** parameters are displayed when a user views site designs as they create a new Team site.
245249

246250
> [!NOTE]
247-
> A site design can run multiple scripts. The script IDs are passed in an array, and they run in the order listed.
251+
> A site template can run multiple scripts. The script IDs are passed in an array, and they run in the order listed.
248252
249-
For step-by-step information about creating a site design, see [Get started creating site designs](get-started-create-site-design.md).
253+
For step-by-step information about creating a site template, see [Get started creating site designs](get-started-create-site-design.md).
250254

251255
## PnP provisioning and customization using Power Automate
252256

253257
One action provided by site scripts is the ability to trigger a Power Automate flow. This allows you to specify any custom action that you need beyond the actions provided natively in site scripts.
254258

255-
If you use the PnP provisioning engine to automate site creation, you can use a Power Automate flow to integrate with site designs. You can maintain all your existing provisioning scripts as well as create new custom provisioning scripts by using this technique.
259+
If you use the PnP provisioning engine to automate site creation, you can use a Power Automate flow to integrate with site templates. You can maintain all your existing provisioning scripts as well as create new custom provisioning scripts by using this technique.
256260

257261
<br/>
258262

@@ -272,11 +276,11 @@ For a step-by-step tutorial about how to configure your own Power Automate flow
272276

273277
## Scoping
274278

275-
You can configure site designs to only appear for specific groups or people in your organization. This is useful to ensure that people only see the site designs intended for them. For example, you might want the accounting department to only see site designs specifically for them. And the accounting site designs may not make sense to show to anyone else.
279+
You can configure site templates to only appear for specific groups or people in your organization. This is useful to ensure that people only see the site templates intended for them. For example, you might want the accounting department to only see site templates specifically for them. And the accounting site templates may not make sense to show to anyone else.
276280

277-
By default, a site design can be viewed by everyone when it is created. Scopes are applied by using the **Grant-SPOSiteDesignRights** cmdlet or the **GrantSiteDesignRights** REST API. You can specify the scope by user or a mail-enabled security group.
281+
By default, a site template can be viewed by everyone when it is created. Scopes are applied by using the **Grant-SPOSiteDesignRights** cmdlet or the **GrantSiteDesignRights** REST API. You can specify the scope by user or a mail-enabled security group.
278282

279-
The following example shows how to add Nestor (a user at the fictional Contoso site) view rights on a site design.
283+
The following example shows how to add Nestor (a user at the fictional Contoso site) view rights on a site template.
280284

281285
```powershell
282286
Grant-SPOSiteDesignRights `
@@ -295,7 +299,7 @@ For more information about working with scopes, see [Scoping access to site desi
295299

296300
## See also
297301

298-
- [Get started creating site designs](get-started-create-site-design.md)
302+
- [Get started creating site template](get-started-create-site-design.md)
299303
- [Apply a scope to your site design](site-design-scoping.md)
300304
- [Site design JSON schema](site-design-json-schema.md)
301305
- [PowerShell cmdlets for SharePoint site designs and site scripts](site-design-powershell.md)

0 commit comments

Comments
 (0)