|
1 | 1 | ---
|
2 | 2 | title: Customizing "modern" lists and libraries
|
3 | 3 | 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 |
5 | 5 | localization_priority: Priority
|
6 | 6 | ---
|
7 | 7 |
|
@@ -270,72 +270,7 @@ If your site happens to use a custom theme, this custom theme is respected in th
|
270 | 270 | <a name="configuremodernlibrariesandlists"> </a>
|
271 | 271 | ## Configure the end user experience
|
272 | 272 |
|
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 |
| - |
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 |
| - |
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. |
339 | 274 |
|
340 | 275 | ## When does the built-in auto-detect automatically switch rendering back to "classic"?
|
341 | 276 |
|
|
0 commit comments