testosaurusdocs
Browse docs
On this page

Widget customization

Make feedback feel at home in your app. Choose a launcher, match your surface and decide how your users encounter capture choices.

Open your project's settings → widget. The preview uses the same widget rendering as the SDK, so you can inspect changes before saving.

Choose your launcher

TestoTesto

The familiar dinosaur, with its signature peek.

Bubble

A compact feedback icon that stays out of the way.

Feedback pill

An icon and visible label for a clearer invitation.

All three styles are available on Free. Testo is the default. Its body peeks above the stationary hands on hover and keyboard focus; reduced-motion preferences are respected. Choose the bottom-left or bottom-right position to fit your application.

Only the visible part of Testo takes taps, the launcher sits above the bottom safe area, and it is smaller on phones, so it does not cover your tab bar or calls to action.

Welcome bubble

The first time a visitor sees the widget on a standard token, a welcome bubble appears after about two seconds and hides itself after five more. I'd love to help opens the feedback panel. Not now shrinks the launcher to a small peek tab for the rest of that browser tab session; clicking or focusing the tab brings the full launcher back, and clicking it opens the panel. The bubble keeps appearing on new page loads until the visitor answers it or clicks the launcher.

To skip the bubble entirely, pass showWelcome: false to Testosaurus.init. Test-session tokens never show it.

Appearance

Choose a light or dark panel surface on every plan. Pro and Enterprise also support a custom accent color and removing the Testosaurus branding. The accent is used across controls and selected states; check both surface and accent together in the preview.

Content

On Pro and Enterprise, edit the panel title, welcome message, message placeholder, send-button label and feedback tags. Use labels that help your users describe what happened. Free projects use the default wording and tags.

Capture choices

Every plan can choose among three consent presentations. These change how the choices appear; opening the widget never grants permission to capture a screenshot or replay. The presentation applies to standard tokens only: test-session tokens show a full-screen consent card on page load instead.

  • Wizard — a guided choice before composing the first report, including a message-only path.
  • Inline checkboxes — screenshot and replay choices beside the message.
  • Separate prompts — individual capture choices alongside the feedback flow.

Each answer is remembered in the visitor's browser until they change it in the widget, which keeps a summary of the current choice with a Change control. Browser context and the user's message remain distinct from optional attachments. Replay inputs are masked by default. See Privacy & consent for the capture rules and test sessions.

Preview before saving

Switch between desktop and mobile sizes, then inspect Welcome, Consent, Compose and Success. The isolated preview does not capture your screen, record a replay, send feedback or change your consent choices.

Changes stay in a draft until saved. Paid controls remain available to preview on Free and are clearly marked; previewing a paid value does not publish it. Save the basic settings that your plan supports, upgrade for paid customization, or discard the draft.

Open from your own button

After the SDK has initialized, call Testosaurus.open() to open the normal widget flow from a button inside your application:

<button type="button" data-feedback>Send feedback</button>
<script>
  document.querySelector('[data-feedback]').addEventListener('click', () => Testosaurus.open());
</script>

It returns true when the mounted widget receives the request and false when no widget is mounted. Consent still applies. See the API reference.

What is included

SettingFreePro / Enterprise
Testo, Bubble or Feedback pillIncludedIncluded
Position, light/dark surface, consent styleIncludedIncluded
Custom accent, wording and tagsPreview onlyIncluded
Remove brandingNot includedIncluded
Something unclear?Let us know