Configure a file preview widget

You can configure a file preview widget to display an embedded file (document, image, or video) that can be previewed from the File Manager on a page. 

Considerations

  • Access permissions: If users don't have access permissions to view the file, they will see a "You do not have permission to view this file" message. 

Who can do this?

  • Workplace administrators 
  • Site administrators

Set up

  1. In the Page Builder, select New Widget.
  2. From the Widget List, select the handlebars beside the file preview widget to drag and drop the widget into place on the Page Builder. See Widget placement on a page for more information on placing widgets on a page. 
  3. Select the placed widget's Edit button.
  4. Review and make changes to the settings in the Configuration side panel. See the Settings section below for more details. 
  5. In the Configuration side panel, select Save to apply your changes or Cancel to discard them.  
  6. At the top of the Page Builder, select Save Page to save your changes.

Settings

Setting Description
Expand / Collapse Select to expand and collapse the configuration side panel for increased visibility. 
Widget Title

Enter a title for the widget. The title appears as a heading above the widget's contents to provide context to the widget and structure the page's content with defined sections.

When entering a title, you do so only for the currently selected language. To enter the title for other languages, select the desired language from the Widget Title Languages dropdown and enter a title in Widget Title. 
Widget Title Text Color

Select a color swatch from the color palette or enter the color's hexadecimal color code to be used for the title's text.

To enter a hexadecimal color code, use the format: #99FF33
Widget Title Bar Background Color

Select a color swatch from the color palette or enter the color's hexadecimal color code to be used for the title bar's background color.

To enter a hexadecimal color code, use the format: #99FF33
Widget Title Languages Select a language from the dropdown to enter a Widget Title translation in the currently selected language.
Make Widget Full Width (Optional) Select to expand the widget to the full width of the available area or page.
Select File for Preview

Select a file to display embedded in the widget. 

You can only view files to which you have access permissions and select files that can be previewed in the digital workplace. See File Preview for file types that can be previewed. 

  1. If no file is selected, choose Select. If a file has already been chosen, select Edit to choose a different file or X to remove the file. 
  2. Select the radio button beside the file or folder you want to use in the widget.
    • Select Expand beside a folder to view its contents.
    • The file you select will only be shown to users with access permissions to view it.
  3. To apply your changes, select Add Selected File.
Height (px)

Enter a height for the widget's display window on the page. Use a pixel height between 300px and 2000px in the format: 300. Or use the arrows to increase or decrease the height by 1px. 

The default value is 500px.
Configuration Settings

Note:

The digital workplace theme determines the appearance of the widget's content unless a widget setting specifically overrides a theme setting. See the Theme article for more information.

Related to