Skip to main content
The widget editor gives you full control over how your widget looks and behaves. Configuration is split across three areas: General settings, Style options, and Tab Content configuration. Each is accessible from the widget editor’s tab bar.
Changes are reflected in the live preview panel on the right side of the editor as you make them, so you can see exactly how your widget will appear to visitors.
The General tab controls the widget’s core settings, agent assignment, footer content, and navigation structure.

Widget title

The widget title appears in the header bar of your widget. It’s typically your product name, brand name, or a short descriptor.
  • Maximum length: 100 characters
  • You can toggle the title on or off — when hidden, the header displays the widget avatar only

Assign agent

Select the agent that powers this widget. Only agents with an Active status appear in the dropdown.The assigned agent determines:
  • The AI model and configuration used for chat responses
  • The tone, guardrails, and compliance settings applied to conversations
  • The resources displayed in the Resources tab
Changing the assigned agent will immediately change the widget’s chat behaviour and available resources. If the widget is already live, visitors will start receiving responses from the new agent.
Add disclaimers, legal notices, or helpful information to the bottom of your widget. The footer supports rich text formatting:
  • Bold, italic, and underline text
  • Hyperlinks
  • Bulleted and numbered lists
  • Maximum visible length: 500 characters

Hide “Powered by RoseRx”

Toggle this setting to show or hide the RoseRx branding at the bottom of the widget.

HCP Verification

Toggle Require HCP Verification to gate widget access behind AHPRA verification. When enabled, visitors must verify their healthcare professional status before accessing widget content.See HCP Verification for full details on how this works.Control the tab bar and tab visibility to shape the visitor experience:
  • Hide/show tab bar — Toggle the tab bar on or off. When hidden, only the default tab is shown.
  • Per-tab visibility — Choose which tabs to display: Explore, Chat, and Resources. You can enable or disable each independently.
  • Default tab — Set which tab visitors see first when they open the widget. This also serves as the home tab when visitors click the home button.
If your widget only needs the Chat experience, hide the tab bar and set Chat as the default tab for a clean, focused interface.

Best practices

Match your brand

Use your brand’s primary colour, logo, and font to create a seamless experience that feels native to your website.

Keep it focused

Only show the tabs your audience needs. A simpler interface leads to higher engagement.

Write clear suggested messages

Use natural, audience-appropriate language. For HCPs, use clinical terminology. For patients, keep it simple.

Test both themes

Preview your widget in both Light and Dark mode to ensure your brand colours and content look good in either setting.