UserHero Docs
Widget Builder

Widget Customization

Customize your widget's appearance to match your brand

Widget Customization

Make your feedback widget feel like a native part of your application with extensive styling options.

Theme

Choose how the widget adapts to your site's color scheme:

ThemeDescription
LightAlways use light mode
DarkAlways use dark mode
AutoFollow user's system preference

Accent Color

Set a custom accent color that appears on:

  • Primary buttons
  • Focus states
  • Links and highlights

Use the color picker or enter a hex code directly:

#3B82F6  (Blue)
#10B981  (Green)
#F59E0B  (Amber)
#EF4444  (Red)
#8B5CF6  (Purple)

Tip: Use your brand's primary color for a cohesive experience.

Border Radius

Control the roundness of corners:

OptionValueStyle
Sharp4pxModern, angular
Rounded8pxBalanced (default)
Pill16pxSoft, friendly

Position

Choose where the floating launcher appears:

PositionDescription
Bottom RightMost common, doesn't interfere with navigation
Bottom LeftGood if you have other widgets on the right

Margins

Fine-tune the position with X and Y margins (in pixels):

  • Margin X: Distance from the edge (16-48px recommended)
  • Margin Y: Distance from the bottom (16-48px recommended)

Launcher Appearance

Label

Customize the button text:

  • "Feedback"
  • "Help"
  • "πŸ’¬ Give Feedback"
  • Or leave empty for icon-only

Icon

Choose from built-in icons:

  • πŸ’¬ Chat bubble (default)
  • πŸ“ Pencil
  • ❓ Question mark
  • 🎯 Target
  • Custom emoji

Size

SizeDimensionsBest for
SmallCompactMinimal footprint
MediumStandardMost sites (default)
LargeProminentWhen feedback is critical

Title

Customize the modal header:

  • "Share your feedback"
  • "How can we help?"
  • "Report an issue"

Placeholder Text

Set placeholder text for the feedback textarea:

  • "Tell us what's on your mind..."
  • "Describe the bug you encountered..."
  • "How can we improve?"

Branding

UserHero Badge

The "Powered by UserHero" badge appears on free plans. Paid plans can remove this badge.

PlanBadge
FreeVisible
Starter+Removable

Live Preview

As you customize your widget, the live preview updates in real-time. Toggle between:

  • Desktop view
  • Mobile view

This helps you ensure the widget looks great on all devices.

Saving Changes

Click "Save" to apply your customizations. Changes take effect immediately on your live siteβ€”no code changes needed.

CSS Custom Properties

For advanced customization, the widget exposes CSS custom properties that you can override:

/* Add to your site's CSS */
.userhero-widget {
  --uh-primary: #3B82F6;
  --uh-radius: 8px;
  --uh-font-family: inherit;
}

CSS customization is considered advanced and may change between versions. Use the dashboard settings when possible.

Next Steps

On this page