Applies ToSharePoint Server Subscription Edition SharePoint Server 2019 SharePoint in Microsoft 365 Microsoft 365 admin SharePoint admin centre SharePoint operated by 21Vianet

When you add a modern page to a site, you can add and customize web parts, which are the building blocks of your page. This article describes the Document Library web part, which allows you to display a document library. 

When you use the document library web part, you can choose to show a specific view of the library or even a folder within the library. Users with appropriate permissions can add, view or edit files directly from the web part. Users can also pin a document to the top of the library, download, delete and rename files, or can go the full document library by clicking See all. Additionally, files can be shown in a details view or tiles view, and column formatting and nested folders created in the source list are shown.

Note: Some functionality is introduced gradually to organizations that have opted in to the Targeted Release program. This means that you may not yet see this feature or it may look different than what is described in the help articles.

Document Library web part on a modern page.

Add a document library to a page

  1. If you want a custom view of your library to appear on your page, create the view.

  2. Go to the page where you want to add the library.

  3. If your page is not already in edit mode, click Edit at the top right of the page. Find the Toolbox (Toolbox icon in content pane) on the right.

  4. Select See all web parts, then select or drag-and-drop Document library from the list of web parts.

  5. Select the document library you want to put on your page.

    Select a document library to put on a page

  6. Click Edit properties (Icon for editing web part and section properties) on the top left side to change the Document library, the View of your library, and the size. You can also display a specific folder in the library by entering the folder name (use a "/" to separate the names of nested folders - in the example below, Projects is a folder in the Documents library, and Presentations is the nested folder):

  7. When you're done, click Apply.

  8. When you're ready, click Publish at the top right of your page.

View documents in a list or as tiles

Users can click the right of the toolbar to change the view of the library from Details (a list view) to Tiles (to view files as icons).

Tiled view in document library

Add new or upload documents

In the web part, users can add new folders and documents and/or upload files and folders. The easiest way to add files and folders is to drag them into the library from another location.

You can also add or upload documents by using the toolbar:

  • Click + New, and select Folder or a document type. Or, click + Upload, and select Files or Folder.

    New and Upload commands

Download, Rename, Delete, and Pin to top

  • When a file is selected, you can take a number of actions, such as download the file, rename it, delete it, or pin it to the top of the library for easy access.

    Delete, Download, and Rename commands

Sort, filter, or group items within the document library web part

In the web part, users can sort, filter, and group items. The actions taken in the web part do not affect the underlying library, and are viewable for the current session only.

  1. Click the down arrow next to the title of the column you want to sort, filter, or group.

  2. Select the action you want to take.

    Document Library web part showing sort, filter, and group menu

Document Library web part on a modern page.

Add a document library to a page

  1. If you want a custom view of your library to appear on your page, create the view.

  2. Go to the page where you want to add the library.

  3. If your page is not already in edit mode, click Edit at the top right of the page.

    Hover your mouse above or below an existing web part and you'll see a line with a circled +, like this:

    Plus sign for adding web parts to a page

  4. Click +, and then select Document Library from the list of web parts.

  5. Select the document library you want to put on your page.

    Select a document library to put on a page

  6. Click Edit web part Web part edit button on the left side to change the Document library, the View of your library, and the size. You can also display a specific folder in the library by entering the folder name (use a "/" to separate the names of nested folders):

  7. When you're done, click Apply.

  8. When you're ready, click Publish at the top right of your page.

Add new or upload documents

In the web part, users can add new folders and documents and/or upload files and folders. The easiest way to add files and folders is to drag them into the library from another location.

You can also add or upload documents by using the toolbar:

  • Click + New, and select Folder or a document type. Or, click + Upload, and select Files or Folder.

    New and Upload commands

Download, Rename, or Delete

  • When a file is selected, you can take a number of actions, such as download the file, rename it, or delete it.

    Download, Rename, and Delete commands

Document Library web part on a modern page.

Add a document library to a page

  1. If you want a custom view of your library to appear on your page, create the view.

  2. Go to the page where you want to add the library.

  3. If your page is not already in edit mode, click Edit at the top right of the page.

    Hover your mouse above or below an existing web part and you'll see a line with a circled +, like this:

    Plus sign for adding web parts to a page

  4. Click +, and then select Document Library from the list of web parts.

  5. Select the document library you want to put on your page.

    Select a document library to put on a page

  6. Click Edit web part Web part edit button on the left side to change the Document library, the View of your library, and the size. You can also display a specific folder in the library by entering the folder name (use a "/" to separate the names of nested folders):

  7. When you're done, click Apply.

  8. When you're ready, click Publish at the top right of your page.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.