How to Get the Freshdesk Widget

In your Freshdesk admin, open Web Chat to reach the "Customize your default widget!" screen, the first stage of a three-step flow shown across the top: Customize, Preview, Launch. This is where you set the brand logo, brand color, button color, and widget launcher color, plus the welcome message and sub-message that greet a visitor. A live preview panel on the right updates as you type, showing the widget exactly as it'll appear on your site — in this case a dark blue panel with a "Hello / Ask us anything" greeting and a Topics list.

Beyond the quick customize wizard, Freshdesk has a separate Widget Configuration page reachable via Admin > Web Chat > Widget Configuration, organized into tabs: Appearance, Content, Preferences, Deploy code, and User authentication. The Appearance tab is where the real detail lives — a left-hand list breaks it into Visual branding, Titles, Profile info, Position & behaviour, and Custom CSS, so you're not scrolling one long form. One option worth knowing about here is the chat background pattern grid, which lets you pick a subtle texture behind the conversation instead of a flat color.

Scrolling further down Appearance reaches Profile info, where you upload a small logo and set the Business name that appears in the widget header — in the preview it reads "Example" until you replace it with your actual brand name. Right below that is Position & behaviour, which controls things like messenger visibility — whether the widget launcher shows on every page or only specific ones. These two sections are what make the widget feel like it belongs to your business rather than a generic Freshdesk demo.

The Content tab next to Appearance is where you decide what visitors actually see inside the widget — a contact form for submitting a ticket, links into your knowledge base articles, or both together as Topics the way the preview shows a "Chat with us" option. Decide this before you spend time on colors, since it changes how much configuration the widget needs; a widget that only shows help articles needs a populated knowledge base behind it, while a pure contact-form widget doesn't.

Once appearance and content are set the way you want, open the Deploy code tab. It generates a small JavaScript snippet tied to your account and this specific widget configuration.

Copy that snippet and paste it into your site's HTML, typically just before the closing body tag, so it loads on every page you want the widget to appear on. Save your changes in Freshdesk first — the Save and Discard Changes buttons sit at the bottom of the configuration panel — or the embed code won't reflect your latest branding.

Before pointing real traffic at the widget, use the Preview step from the original three-stage wizard to click through it as a visitor would, checking that colors render correctly and the welcome message isn't cut off. Once it looks right, Launch makes it live. If you hit an error while saving — Freshdesk will show a red banner reading something like "Error while updating widget details" — re-check required fields like brand color before retrying, since a missing value is the most common cause.