Ferndesk
Self-serve widget

Configure widget settings

Customize your Self-Service Widget to match your brand and support workflow. All settings update in real-time preview before saving.

You'll need admin or owner access to customize widget settings.

Access Widget Settings

  1. Open your Ferndesk dashboard

  2. Navigate to Help Center → Widget

  3. Click Customize widget

Branding

Control your widget's visual identity:

  • Logo: Upload PNG, JPG, or SVG (recommended 512x512px)

  • Primary color: Brand color for buttons and accents

  • Color scheme: Choose system, light, or dark mode

  • Button color: Customize the launcher button background

  • Button icon: Select from available icons

  • Heading font: Choose from Google Fonts

  • Body font: Choose from Google Fonts

Square logos work best. The widget automatically resizes images to fit.

  • Title: Main heading (default: "How can we help?")

  • Background: Custom background color or image

AI Answers

Enable AI-powered chat to help customers find answers through natural language queries. When enabled, the widget shows a chat interface that synthesizes answers from your published articles with inline citations.

The AI assistant only searches published content. Make sure you've published relevant articles before enabling this feature.

Add up to 5 quick-access links to your widget. Each link includes:

  • Icon: Choose from available icons

  • Label: Link text

  • URL: Destination (internal or external)

Drag and drop to reorder links.

Contact

Choose how customers reach your support team:

Email

Display a contact form that sends messages to your support email. Customers can attach up to 3 image files (JPEG, PNG, GIF, WebP, HEIC, HEIF) up to 5MB each.

Configure:

  • Support email address: Where messages are sent

  • Contact title: Heading on the contact page

  • Contact description: Brief explanation

  • Button text: Submit button label (default: "Get in touch")

Redirect users to an external support page or ticketing system.

  • Contact link URL: Destination URL

  • Button text: Button label

File uploads are only available with the Email contact method.

None

Hide the contact option for fully self-service support.

Powered By

Toggle the "Powered by Ferndesk" link in the widget footer on or off.

Install

Copy the embed code snippet and paste it into your site's HTML before the closing </body> tag. The snippet includes your unique widget ID and loads the widget automatically.

Changes to widget settings apply immediately to your live widget after saving.

Was this helpful?