Built-in Widgets
Built-in Widgets are pre-made widget templates provided by JASP that you can activate with a single click. They offer ready-to-use functionality without requiring you to write any code.
What are Built-in Widgets?
Built-in Widgets are professionally designed templates that cover common use cases. They come with:
- A complete template (HTML/Handlebars markup and CSS)
- Pre-configured widget settings fields that content editors can fill in
- Translations for supported languages
- API configurations where applicable
- A help text section explaining how to use the widget
Unlike Custom Widgets, Built-in Widgets are maintained by JASP and receive automatic updates when new versions are published.
How to Activate a Built-in Widget
- Open the Widget Builder and navigate to Built-In Widgets in the sidebar.
- Browse the available widgets. Each card shows the widget name, status, and last updated date.
- Click on a widget card to open its detail view.
- In the detail view, toggle the activation switch to On.
The widget is now active and available for content editors to use in Staffbase. You can preview the widget and its settings form directly on the detail page.
Activating or deactivating a Built-in Widget takes effect immediately -- there is no separate save step.
How to Customize a Built-in Widget
Built-in Widgets cannot be edited directly. To customize one:
- Open the Built-in Widget detail view.
- Click the Copy & Edit button.
- A new Custom Widget is created as a copy of the built-in template.
- Edit the copy freely in the widget editor -- change the template, add fields, modify translations, etc.
The copy is independent from the original Built-in Widget. Updates to the built-in version will not affect your custom copy.
For a step-by-step walkthrough, see Customize a Built-in Widget.
Built-in vs. Custom Widgets
| Built-in Widgets | Custom Widgets | |
|---|---|---|
| Created by | JASP | You |
| Editable | No (read-only) | Yes (full editor access) |
| Automatic updates | Yes (new versions from JASP) | No |
| Activation | Toggle on/off | Toggle on/off |
| Customizable | Via "Copy & Edit" (creates a Custom Widget) | Directly |
| Exportable | Yes | Yes |
| Version history | Managed by JASP (version numbers visible) | Not versioned |
Version Updates
When JASP publishes a new version of a Built-in Widget, you will see a notification on the widget detail page. If you have the widget activated, it updates automatically. The version number is displayed below the widget title.
If you previously created a custom copy of a Built-in Widget, the copy is not affected by version updates. You would need to create a new copy from the updated built-in version to get the latest changes.