Skip to main content
The Egentify chat widget is fully customizable to match your storefront’s brand without any code changes. Adjust colors, positioning, welcome messaging, and quick-reply buttons to create a seamless experience that feels native to your store.

​
Where to customize

Appearance settings (colors, welcome text, starter buttons) are in the Egentify app in your Shopify admin under the Settings tab.Position and offsets (widget corner, horizontal/vertical offset, corner radius) are configured in your Shopify admin under Online Store > Themes > Customize > App Embeds — select the Egentify chat widget entry there.

​
Appearance settings

SettingDescriptionDefault
primary_colorThe accent color used for the widget launcher, send button, and interactive elements. Set as a hex value.#3158c1
widget_positionWhich corner of the screen the widget launcher appears in.bottom-right
widget_offset_xHorizontal distance (in pixels) between the widget launcher and the edge of the screen. Accepted range: 0–200 px.20
widget_offset_yVertical distance (in pixels) between the widget launcher and the bottom of the screen. Accepted range: 0–200 px.20
widget_window_corner_radiusThe corner radius of the chat window in pixels. Set to 0 for sharp corners or up to 30 for fully rounded.12
agent_nameThe agent’s name displayed in the widget header.Nova
agent_avatar_storage_pathA custom avatar image shown in the widget header and next to agent messages. Upload a PNG or JPG from the settings page.Egentify default avatar

​
Welcome text and starter buttons

The welcome text is the first message customers see when they open the chat widget. Use the {{agent_name}} placeholder to automatically insert your agent’s name: 
Hi there! I'm {{agent_name}}. How can I help you today?
The welcome text supports up to 300 characters. Starter buttons appear below the welcome message the first time a customer opens the widget, giving them one-tap shortcuts to common requests. You can configure up to 4 buttons, each up to 40 characters long. Example starter buttons:
  • Track my order
  • Return an item
  • Product question
  • Talk to a person
Choose labels that reflect the most common reasons your customers reach out — this reduces the time it takes for customers to get help and gives the AI useful context from the very first interaction.
Changes to widget settings take effect immediately — no page reload or re-deployment needed.