Skip to main content

Embed widget

The Ducalis widget notifies users about new features and allows them to leave feedback directly in your product. Embed it to increase engagement with your Voting Board, Roadmap and Changelog.

Open widget

It also helps collect feedback from users without interrupting their workflow.

Embed widget button

Live demo: Visit https://hi.ducalis.io/ and click New in the header menu.

Embed anywhere​

Embed the widget on any page where you want to collect feedback or show new features notifications.

At Ducalis, we embed the widget on:

Set up the widget​

warning

If your Voting Board is private with access restrictions, you must pass user identities to the widget. Otherwise, no one can access it.

Open Voting Board settings​

  1. Go to Voting Board settings.

  2. Find Embed section. Click on Feedback / Changelog / Roadmap widget.

Where to find in-app widget code

Install widget code​

  1. Copy and paste the HTML code into your website, app, or any page where you want it to appear. Save changes.
Copy the code from settings

For example,

Paste code to the sites
  1. Then click Verify.
Verify installation
  1. A confirmation message will appear, showing the verification result.
See the verification result Verification status

Installed widget example:

Installed widget example

Choose Pages To Show​

  1. Set up which sections you want to show when users open the widget.
Choose what pages show in widget
  1. Save changes to apply them.
Save changes about what pages show in widget

By default, the Feedback Form is always shown to give users the opportunity to leave feedback.

For example, if you choose Public Roadmap, the widget will show the Feedback Form and Roadmap sections, while the Changelog will not be shown.

Example of roadmap shown first

Choose What to Open First​

  1. Set up what to open first when users click the widget button.
The setting where you can choose what open first
  1. Click Save to apply changes.
Save changes what open first

For example, if you choose Changelog, when a user clicks the widget, the changelog will open first.

Customize Widget Appearance​

Create a style theme for the widget — including background color, text color, widget placement, button label, and corner radius.

Background Color​

Setup your brand color

Text Color​

Setup your brand text color

Placement​

Setup your widget position on your site - left or right

Button Label​

Customize the text.

Customize the widget button label text

Widget features in base configuration​

This base setup provides:

  • Widget displays latest Ideas in Done status, sorted by release date on Changelog page
  • Notification bubble for newly released features (Ideas moved to Done)
  • Visitors can read up to 20 released Ideas
  • Link to Voting Board to check roadmap, add Ideas, upvote, and comment
  • Email capture for roadmap weekly digest updates

Identify Your Users​

Choose between Ducalis authentication or your own authentication method.

Option 1: Use Ducalis authentication (default)

By default, Ducalis authentication is used when customers want to vote, add Ideas, or comment.

Option 2: Use your own authentication

If you use your own authentication, specify it in code: onAuth: showUserAuth

When this function is specified, it replaces Ducalis authentication. You handle the entire authentication process, but you must pass the authenticated widget user: user.email + user.hash are required.

Last updated: Last week