All Collections
Frequently asked questions about features
How do I create widgets in the library?
How do I create widgets in the library?

Widgets allow you to prominently display static pages in the library alongside your learning content.

Adrian Fuchsluger avatar
Written by Adrian Fuchsluger
Updated over a week ago

Widgets are used to display static pages within the learning library. This highlights the static pages prominently and ensures that the app menu items are reduced.

Display of widgets on desktop and mobile.

Concrete use cases for widgets are, for example:

  • Integrate external learning courses from other platforms

  • Point to internal company pages

  • Create a gallery of the latest information

Add a widget to the library

To add a widget to the library, navigate to the Library in the Create area.

Navigate to the "Library" in the "Create" area.

Click on Add and select Widget.

Under "Add" you will find the entry "Widget".

A creation window opens in which you must assign a title for the new widget.

Assign a title in the new creation window.

The widget type determines the content that the widget displays. Currently, you can only select the "Static page" type here. Further types are under development. A widget can initially be created in the Draft status. The widget only becomes visible in the app with the status Published. You can also select a size and one or more content packages.

Visibility of a widget

A widget must be assigned to a content package in order to be visible in the app. The same rules apply to the widget as for decks. If a user has access to a content package in which the widget is located, the widget is displayed for the user. You can find out more about content packages in the article: How do I create a content package?

Size of a widget

You can specify a size for each widget. The size determines how the widget is displayed in the library. You can choose from the following three sizes:

  • Small

  • Square

  • Banner

The "Small" size is the default value. Widgets in this size are the same size as topics. With the "Square" size, the widget appears in a square format and is therefore taller but the same width as the "Small" size. The "Banner" size displays the widget in its entire width. On smartphones, the banner is therefore displayed as a "Small" size, and in the desktop version as a large banner.

Darstellung aller verfügbaren Größen.

All three sizes compared with one topic.

A detailed description of all sizes can be found in the article: What widget sizes are available?

Our recommendation: Alternate between the different sizes to create an interesting layout in your library. The "banner" is particularly suitable as an introduction to the library or under a headline.

Add static pages to a widget

Before you fill a widget with content, you must create static pages. You can find out how to create static pages in the article: How do I create static pages?

Widgets can display static pages of any type. They are best suited for text pages, external links or iFrames. To add a static page, switch to the Content tab. All static pages that have already been added are displayed in this tab. Click on Add static page to add a new static page to the widget.

Click on "Add static page" to add a static page.

An entry for a static page appears. First select which static page you would like to add. All available static pages are displayed in the selection.

For each added static page, you can determine how it should look in the widget. You can either upload a static image or display an external website in the widget as an iframe.

If you select static image, you can upload your own image. You can also add a subline and write a customised call-to-action. If you do not create a call to action, the default label "Explore" will be used. The title of the static page is also displayed in the widget.

Each static page can have a subtitle and an individual call-to-action.

In the banner size, a widget with a static background image is displayed as follows:

Darstellung eines Banner-Widgets mit einem statischen Hintergrundbild.

If you select "Render iframe within the widget", you can enter a URL to display the external website within the widget. The title of the website is displayed in the widget as a header. Users can operate the website in the widget and call up the stored static page via the header.

Concrete use cases for the iFrame display are

  • Display data such as statistics from external websites on a user-specific basis

  • Embed a video stream (e.g. YouTube or Vimeo) in the widget

  • Embed an external form

Display of widgets with iFrame function.

Note: Use "embed" links for embedding, other links could be blocked by the external platform. If the external website uses cookies, make sure that the same top-level domain is used for your ovos play instance and the external website. If necessary, please get in touch with your contact person at ovos.

Create a gallery in the widget

You can add several static pages to a widget. One entry per static page is displayed in the widget. With multiple static pages, the widget appears as a gallery. Users can swipe through the static pages or navigate using the navigation bar at the top.

Darstellung einer Widget-Galerie in der App.

The gallery is particularly suitable for summarising thematically similar static pages, such as several external learning courses.

To create a gallery, edit the desired widget and switch to the Content tab. Click on Add static page to add a static page to the widget.

Click on "Add static page" to add several static pages.

You can add as many static pages as you like. As soon as there are at least two visible static pages in a widget, a gallery is displayed in the app.

Display of several added static pages.

Did this answer your question?