HTML Content widget
Use the HTML Content widget to display custom content on your digital workplace's pages, spaces, and dashboards. The HTML Content widget leverages the WYSIWYG editor to create content that includes text, images, videos, and embedded content from elsewhere in your digital workplace or third-party sources.
Sections in this article:
Considerations and caveats
- JavaScript in the WYSIWYG editor. Refer to our Developer KB article Accessing the WYSIWYG editor to learn more about how to use JavaScript in the WYSIWYG editor.
- Embedded content is not showing. When you embed content from a third-party site, ensure that the URL is for a site that uses SSL. Your digital workplace will not display content from sites that do not use SSL. URLs from sites that use SSL will begin with HTTPS instead of HTTP.
- Page load times. HTML Content widgets can run complex code, display high-quality images, and pull information from a variety of sources inside your site and out. All these functions can increase the load time of a page, especially if they are waiting on third-party services for data.
Set up
Before configuring the widget, you must place it on a page, space, or dashboard. For more information, see Placing and setting up a widget.
Once placed, select the widget's Edit button to open the widget editor. In the widget editor, review and make changes to the settings found on the Options, Layout, and Appearance tabs. Details about the widget's settings can be found in the Settings section below.
After making changes to the widget, you must select Update to apply them or Cancel to discard them. Both of these options are found at the bottom of the widget editor. You must also Publish or Save as Draft the page, space, or dashboard you are working on to save your changes.
Settings
Options
The following settings are available on the Options tab:
| 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 give users an idea of why the widget's content is important to them or highlight the content's purpose. Titles also 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. Can contain a maximum of 140 characters. |
| Content | Enter the content that the widget displays. For more information about the WYSIWYG editor, see WYSIWYG editor. Common workflows include:
|
| Show content to: | Select who can view the widget. Options include:
|
Layout
There are currently no Layout settings.
Appearance
Your digital workplace's theme overwrites many of the settings on this tab. However, the following settings are useable:
| 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. By default, the widget is set to Auto (left most position of the slider), which scales the widget's height to fit its contents. You can use the slider to set a fixed height between 50px to 600px in increments of 50px. |
How users interact with it
What content you put in the HTML Content determines how users can interact with it. Some potential use cases include:
- Static banners and messages
- Welcome videos on a landing page
- Embedded surveys and documents
- Custom functionality (e.g., displaying a media feed, or the weather)