Documents
The Sprocket Documents web part enables you to display and manage documents from any SharePoint document library directly on your page. Connect to libraries across site collections, customize which fields to display, apply filters, and organize documents by metadata groups to create tailored document views for your users.
Features
- Connect to any document library from any SharePoint site (cross-site collection)
- Type ahead results filter
- No need to configure a SharePoint view, just select the fields you wish to display in the webpart
- Specify filters
- Group by meta data field
- Create filters using query strings and page data
- Flatten files without folders
- Show documents within a specific folder
- Use within 'Full-Content' section
Configuration
Adding the Web Part
- If you are not already in edit mode, click Edit at the top right of your page.
- Click the + icon to add a new web part to your page.
- Search for and select Sprocket Documents.
- Configure the web part settings using the property pane on the right.
Display Options
The Documents web part offers the following display configuration settings:
| Setting | Description | Options/Values | Default |
|---|---|---|---|
| Show Breadcrumb | Display breadcrumb navigation showing the current folder path | On / Off | Off |
| Column Minimum Width | Set minimum width for all columns (in pixels) | 0 - 500 px | 0 (auto-sized) |
| First Column Minimum Width | Set minimum width for the first column excluding icon (in pixels) | 0 - 500 px | 0 (auto-sized) |
| Maximum number of items | Limit the number of documents displayed | 1+ | - |
| Show Command Bar | Display command bar with See All button to view all documents | On / Off | Off |
| Show Filter | Display search filter to find specific documents using keywords | On / Off | Off |
| Compact View | Use compact list layout for denser document display | On / Off | Off |
| Show File Type | Display file type column in the document list | On / Off | Off |
| Show Folders | Include folders in the document listing | On / Off | Off |
| Wrap Rows | Allow row content to wrap to multiple lines | On / Off | Off |
| Enable Vertical Scroll Bar | Add vertical scrolling within the web part | On / Off | Off |
| Height | Set web part height when vertical scrolling is enabled | 100+ px | 400 px |
| Open list in new tab | Open the full document list in a new browser tab when clicking See All | On / Off | Off |
| Group Collapsed | Display grouped items in collapsed state by default | On / Off | Off |
Query Options
Configure the document source and display settings:
| Setting | Description | Required | Options/Values |
|---|---|---|---|
| Site URL | Select the SharePoint site containing the document library | Yes | Dropdown of available sites |
| Web URL | Select the web within the site | Yes | Dropdown of available webs |
| Document Library | Select the document library to display | Yes | Dropdown of available libraries |
| Folder | Specify a folder path to display documents from a specific folder For nested folders, use '/' as separator (e.g., Folder1/Subfolder2) | No | Text input |
| View Fields | Select which metadata columns to display in the list | Yes | Checkboxes for available fields |
| Order By | Choose the field to sort documents by | No | Dropdown of available fields |
| Sort Direction | Set the sort order | No | • Ascending • Descending |
| Query within folders | Include documents from subfolders in the results | No | On / Off |
| Group By | Group documents by a metadata field | No | Dropdown of available fields |
Using Filters
Filters enable you to control which documents are displayed in the web part. To add filters:
- Click the Add Filter button in the Filters section
- Select the field, operator, and value(s) for your filter
- Use And/Or conditions to combine multiple filter expressions
- Build complex queries to precisely control document visibility
FAQs
1. What is the maximum allowed file size of a document?
There is no maximum file size - any document size is allowed as per SharePoint specifications.
2. What are the allowed file types?
All SharePoint-allowed file types are allowed, however currently Excel and PowerPoint templates will open in Display Mode.
3. How can I find a specific item in the list?
You have the option to search for items in the list.