Skip to content

Commit bb23597

Browse files
committed
Doc updates to remove tenant level opt out of lists and libraries
1 parent 21cfa0f commit bb23597

7 files changed

+13
-80
lines changed

docs/solution-guidance/modern-experience-customizations-customize-lists-and-libraries.md

Lines changed: 2 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Customizing "modern" lists and libraries
33
description: Get a faster, more intuitive, and responsive SharePoint Online experience by customizing your lists and libraries to the "modern" experience using user custom actions and custom branding.
4-
ms.date: 11/09/2017
4+
ms.date: 03/04/2019
55
localization_priority: Priority
66
---
77

@@ -270,72 +270,7 @@ If your site happens to use a custom theme, this custom theme is respected in th
270270
<a name="configuremodernlibrariesandlists"> </a>
271271
## Configure the end user experience
272272

273-
You have multiple options to control whether the "modern" or "classic" library and list experience is used.
274-
275-
### Tenant level configuration
276-
If you want to completely disable the "modern" experience, it's best to use the tenant setting for this. Go to your tenant admin center (for example, contoso-admin.sharepoint.com), go to Settings, and select the "classic" experience.
277-
278-
**SharePoint lists and libraries experience settings in the SharePoint Admin UI**
279-
280-
![SharePoint lists and libraries experience settings in the SharePoint Admin UI](media/modern-experiences/lists-libraries-tenant-settings.png)
281-
282-
> [!NOTE]
283-
> - When you switch between **New experience (auto detect)** and **Classic experience**, the change is not immediately visible.
284-
> - When you select **New experience (auto detect)**, you always see the **Return to classic SharePoint** option. This is by design given that today not all functionalities of "classic" lists and libraries are implemented in the "modern" lists and libraries. There's no option to change this behavior.
285-
286-
### Site/Web level configuration
287-
You can prevent a site collection or web from using the "modern" experience by enabling a feature:
288-
289-
- For site collection control, use the site collection scoped feature with ID **E3540C7D-6BEA-403C-A224-1A12EAFEE4C4**.
290-
- For web control, use the web scoped feature with ID **52E14B6F-B1BB-4969-B89B-C4FAA56745EF**.
291-
292-
Use the following [PnP PowerShell](http://aka.ms/sppnp-powershell) to enable/disable the needed features:
293-
294-
```powershell
295-
# Connect to a site
296-
$cred = Get-Credential
297-
Connect-PnPOnline -Url https://[tenant].sharepoint.com/sites/siteurl -Credentials $cred
298-
299-
# Prevent modern lists and libraries at site collection level
300-
Enable-PnPFeature -Identity E3540C7D-6BEA-403C-A224-1A12EAFEE4C4 -Scope Site
301-
# And again enable modern lists and libraries at site collection level
302-
#Disable-PnPFeature -Identity E3540C7D-6BEA-403C-A224-1A12EAFEE4C4 -Scope Site
303-
304-
# Prevent modern lists and libraries at web level
305-
#Enable-PnPFeature -Identity 52E14B6F-B1BB-4969-B89B-C4FAA56745EF -Scope Web
306-
# And again enable modern lists and libraries at web
307-
#Disable-PnPFeature -Identity 52E14B6F-B1BB-4969-B89B-C4FAA56745EF -Scope Web
308-
```
309-
310-
### List/Library configuration
311-
If you want to control the experience at the library level, you can go to **List settings** > **Advanced settings**, and change the behavior.
312-
313-
**List experience configuration in the SharePoint tenant level settings in Admin UI**
314-
315-
![List experience configuration in the SharePoint tenant level settings in Admin UI](media/modern-experiences/list-experience-setting.png)
316-
317-
The same can also be done by using CSOM as shown in this snippet:
318-
319-
```csharp
320-
// Load the list you want to update
321-
var list = context.Web.Lists.GetByTitle(title);
322-
context.Load(list);
323-
context.ExecuteQuery();
324-
325-
// Possible options are Auto (= what it's defined at tenant level), NewExperience (= "modern") and ClassicExperience
326-
list.ListExperienceOptions = ListExperience.ClassicExperience;
327-
328-
// Persist the changes
329-
list.Update();
330-
context.ExecuteQuery();
331-
```
332-
333-
> [!NOTE]
334-
> - The settings at the library level *override* the settings at the web, site, or tenant level. This also implies that you could pilot the "modern" list and library experience to a subsite of sites by having the "modern" experience turned off at the tenant level but enabled at the list level on the pilot sites.
335-
> - When you've manually chosen "classic" (that is, not due to list, site, web, or tenant "classic" enforcement), you'll see the link **Exit classic experience** appearing under the left navigation (as of July 2017). Selecting this brings you back to the "modern" experience.
336-
> - If you're not able to get the "modern" experience to appear, inspect the cookies being passed to SharePoint because it is possible that the opt out of "modern" experiences cookie (splnu with value set to 0) is still present. Clearing the browser cookies should fix this.
337-
338-
<a name="autodetect"> </a>
273+
You have multiple options to control whether the "modern" or "classic" library and list experience is used. Check out the [Opting out of the modern list and library experience](../transform/modernize-userinterface-lists-and-libraries-optout.md) article for more details.
339274

340275
## When does the built-in auto-detect automatically switch rendering back to "classic"?
341276

docs/solution-guidance/modern-experience-customizations.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Customizing the "modern" experiences in SharePoint Online
33
description: An overview to get you started using the "modern" experiences in SharePoint Online.
4-
ms.date: 5/10/2017
4+
ms.date: 03/04/2019
55
localization_priority: Priority
66
---
77

@@ -53,7 +53,7 @@ Following are the key scenarios currently supported by the "modern" experiences.
5353

5454
Existing collaboration sites cannot be converted to "modern" team sites with an associated Office 365 group, but you can however [associate a new Office 365 group](https://docs.microsoft.com/en-us/sharepoint/dev/transform/modernize-connect-to-office365-group) to existing collaboration site. You can also start using modern page and list experiences in the classic sites, which will make them look like a modern group associated team sites.
5555

56-
"Modern" lists and library usage can be controlled at the tenant, site, web, and list/library level. You can find more details about the available options in our ["modern" list and libraries](modern-experience-customizations-customize-lists-and-libraries.md) article.
56+
"Modern" lists and library usage can be controlled at site, web, and list/library level. You can find more details about the available options in our ["modern" list and libraries](modern-experience-customizations-customize-lists-and-libraries.md) article.
5757

5858
By default, "classic" SharePoint sites use modern pages for any newly added page, and you have the option to change the welcome page to a modern page. Setting a new "modern" page for a "classic" SharePoint site can be done programatically by using CSOM or REST APIs.
5959

Loading
Loading

docs/transform/modernize-classic-sites.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Modernize your classic SharePoint sites
33
description: Steps to transform your SharePoint classic site into a modern Office 365 group-connected team site or communication site.
4-
ms.date: 04/23/2018
4+
ms.date: 03/04/2019
55
ms.prod: sharepoint
66
localization_priority: Priority
77
---
@@ -22,7 +22,7 @@ All of this is great, but you might ask yourself, *I have lots of classic (team)
2222
2323
## Enable your site to fully leverage the modern user interface
2424

25-
The most visible aspect of a modern site is its modern user interface. If you haven't turned off the modern experience at the tenant level (the **SharePoint Lists and Libraries experience** setting in the tenant admin center), certain pages appear in the modern user interface:
25+
The most visible aspect of a modern site is its modern user interface. If you haven't turned off the modern experience, certain pages appear in the modern user interface:
2626

2727
- List and library pages for most lists and libraries
2828
- Site contents page
@@ -34,8 +34,6 @@ However, if you navigate your site, you will notice that the following pages sti
3434
- Home page and all other site pages (wiki pages and/or web part pages)
3535
- List and library pages for certain lists and libraries
3636

37-
You probably already have the out-of-the-box modern user interface for lists and libraries enabled at the tenant level, so it makes sense to further maximize its use. SharePoint tries to show your lists and libraries by using the modern user interface, but you might have customizations or configurations that prevent this.
38-
3937
To maximize the use of the modern user interface for your site pages and list and library pages, see [Modernize the user interface](modernize-userinterface.md).
4038

4139
To learn more about how to unblock your lists and libraries when using the modern user interface, see [Maximize use of modern lists and libraries](modernize-userinterface-lists-and-libraries.md).

docs/transform/modernize-userinterface-lists-and-libraries-rollout.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,14 @@ localization_priority: Normal
1010

1111
The modern list and library experience is enabled by default and for most customers this is a good model as that immediately brings the benefits of the modern list and library user interface. If you however want to more control of the rollout you can adopt one of the below described approaches.
1212

13-
## Approach 1: the default approach
13+
## Approach 1: recommended, the default approach
1414

15-
In this approach we leave the modern list and library experience active at tenant level but do run the [SharePoint Modernization scanner](https://aka.ms/sppnp-modernizationscanner) to understand which lists are not yet ready for the modern experience. If a site contains multiple of these lists or if the users of a given site are not yet ready for modern you can selectively disable the modern experience for that site. This gives you the needed time to remediate the lists or to educate the users so that later on you can enable the modern experience again.
15+
In this approach we do run the [SharePoint Modernization scanner](https://aka.ms/sppnp-modernizationscanner) to understand which lists are not yet ready for the modern experience. If a site contains multiple of these lists or if the users of a given site are not yet ready for modern you can selectively disable the modern experience for that site. This gives you the needed time to remediate the lists or to educate the users so that later on you can enable the modern experience again.
1616

17-
![The default approach](media/modernize/modernuirollout_1.png)
17+
![The default approach](media/modernize/modernuirollout_1_update.png)
1818

1919
## Approach 2: the "full control" approach
2020

21-
If you want to only enable the modern list and library experience after you've ensured the lists and your users are ready for it you can opt for this "full control" approach. You start with disabling the modern list experience at tenant level (you probably already did this) and then enable the modern experience site level blocking feature. Once you've blocked the modern experience for all sites you can enable modern at tenant level. At this point all sites will still use the classic list experience but it does allow you to run the [SharePoint Modernization scanner](https://aka.ms/sppnp-modernizationscanner) and remediate the needed lists. Once the lists and your users are ready you can selectively again disable the modern experience site level blocking feature. Recommended is to do this work in a number of waves until all sites are using the modern list and library experience.
21+
If you want to only enable the modern list and library experience after you've ensured the lists and your users are ready for it you can opt for this "full control" approach. You start with disabling the modern list experience at site collection level by enabling the modern experience site level blocking feature. At this point all sites will still use the classic list experience but it does allow you to run the [SharePoint Modernization scanner](https://aka.ms/sppnp-modernizationscanner) and remediate the needed lists. Once the lists and your users are ready you can selectively again disable the modern experience site level blocking feature. Recommended is to do this work in a number of waves until all sites are using the modern list and library experience.
2222

23-
![The full control approach](media/modernize/modernuirollout_2.png)
23+
![The full control approach](media/modernize/modernuirollout_2_update.png)

docs/transform/modernize-userinterface-lists-and-libraries.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Following are the most commonly used list template types that SharePoint can cur
3737
In this section you'll learn how to identify lists which are not showing as a modern list, why that is and how to remediate those (if possible). However before jumping into this, it's important to realize that for most tenants we see the majority of the lists loading in modern without any caveats. Lists that don't load in modern either stay in classic (like the calendar or tasks list) or can be unblocked by remediating them, which is the scope of this article series. Lists which do not load as modern list are 100% fine to use, fully supported and they should not hold you back from enabling the modern list and library experience for your tenant.
3838

3939
> [!IMPORTANT]
40-
> For most tenants there are not that many lists that require remediation and as such **our recommendation is to enable the modern list and library experience at tenant level**. This will ensure that all lists that can use modern present themselves as a modern list while lists that cannot simply switch to classic when you use them.
40+
> SharePoint will automatically default to modern lists and libraries, but will also automatically fallback when needed. This will ensure that all lists that can use modern present themselves as a modern list while lists that cannot simply switch to classic when you use them.
4141
4242
## Detect lists and libraries not available in the modern user interface
4343

@@ -100,7 +100,7 @@ var list = context.Web.Lists.GetByTitle(title);
100100
context.Load(list);
101101
context.ExecuteQuery();
102102

103-
// Possible options are Auto (= what it's defined at tenant level), NewExperience (= "modern") and ClassicExperience
103+
// Possible options are Auto (= defaults to modern), NewExperience (= "modern") and ClassicExperience
104104
list.ListExperienceOptions = ListExperience.Auto;
105105

106106
// Persist the changes

0 commit comments

Comments
 (0)