Folder Contents widget

This widget displays the files and sub-folders stored within a Folder channel. The different display options allow you to show as much or as little information as you would like.

Sections in this article: 

Set up

  1. Place a Folder Contents widget on a page, space, or dashboard. For more information, see Placing and setting up a widget. 
  2. Select the placed widget's Edit button.
  3. Review and make changes to the settings on the Options, Layout, and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  4. In the widget editor, select Update to apply your changes or Cancel to discard them.  
  5. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.

Settings

Options tab

General Options
Setting Description
Title

 Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select Translation and enter a title for each supported language.  

This field can contain a maximum of 140 characters.
Title link Select to link the widget's title to the selected folder channel or folder. Users who select the widget's title, if it has one, will go to this location.
Description

Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select Translation and enter a description for each supported language.

Source

Select a folder channel or folder. Content from this source will display in the widget. 

Access rules determine what users will see when configuring and viewing the widget: 

  • Users who are configuring this widget will only see folder channels and folders that meet both of these conditions:
    • The user must have at least Read access to the folder channel or folder.
    • The user must have at least Read access to all locations above where the folder channel or folder is nested.
  • Only users who have Read access or higher to the selected folder channel or folder will see content in the published widget. These users will only see content to which they have at least Read access. 

To select a folder channel or folder:

  1. Select the Source dropdown. If there is an existing source in this field, select it.
  2. Search for a folder channel or folder by its name. This search will return up to 100 results and include the pages and spaces that contain a folder or folder channel that matches the search query.
  3. Select a folder channel or folder from the list of search results.
Include

Select the type of content to include in the widget. Options include:

  • Folder and Documents
  • Folders only
  • Documents only
Show hidden items

Select to show hidden folders and documents. Hidden items are otherwise only visible to users that have at least Edit access.
Sort options

Select how to sort content in the widget. Options include:

  • Title
  • Comments
  • Size
  • Type
  • Created by
  • Last Modified
  • Modified by
  • Views

You can then select whether the sort order is ascending or descending.
Number of results

Enter the maximum number of results to increment by, and to display initially. You must enter a value between 1 and 99. If there are additional items to display, users can select the View All link found at the bottom of the widget to go to the source folder channel or folder.
Show add link

Select to add an Upload a file button to the widget. Only users with at least Write access to the connected folder channel or folder can see this button. These users can select this button to add content to the connected folder channel or folder.

Layout tab

General Options
Setting Description
Choose a layout

Select one of the following layouts:

  • Detail: Provides the most information, options, and interaction.
    The Detail layout.
  • List: Provides a clean and compact view of files and folders.
    The List layout.
  • Tile: Provides a grid view with file types clearly presented as icons.
    The Tile layout.
  • Thumbnail: Provides a small image preview of the file contents where possible. It works well for galleries of images.
    The Thumbnail layout.
Customize your layout The available layout options depend on which layout is selected. See the Customize your layout section below. 

Appearance Tab

Setting Description
Class

 Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets.
Height

 Select the height of the widget. Options include:
  • Auto: The leftmost slider position. The height of the widget will increase and decrease to contain what it is displaying.
  • Fixed: Select a fixed height between 50px to 600px in increments of 50px. A vertical scrollbar will appear on the widget if the content exceeds this fixed value.

Note

Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.

Customize your layout

The available layout options depend on which layout is selected.

Layout option Detail List Tile  Thumbnail  
Description ✔
✖
✖
 ✖
Comments ✔ ✖ ✖ ✖
Size ✔ ✖ ✖ ✖
Likes ✔ ✖ ✖ ✖
Type ✔ ✖ ✖ ✖
Created by ✔ ✔ ✔ ✖
Last Modified ✔ ✖ ✔ ✖
Modified by ✔ ✖ ✖ ✖
Views ✔
✔
 ✖ ✖

Best practices

Effective use of space

To save valuable real estate on your page or space, reduce the number of results shown in your widget and then hyperlink the folder to the folder channel so members can access more if needed.

The hyperlink title and number of results settings on the Options tab.