# Gately Embeddable Chat Widget

By kayode•January 17, 2026•4 mins

We’ve completely rebuilt the **Gately Chat Widget** from the ground up—with a strong focus on **performance, reliability, and developer experience**.

The result? A lighter, faster, and easier-to-install widget that delivers **AI-powered support directly connected to your Help Center**.

Whether you’re embedding Gately on a marketing website, product dashboard, SaaS app, or documentation portal, the new widget provides a seamless chat and AI answer experience with minimal setup.

## Built for Speed, Simplicity, and Scale

The new Gately Chat Widget is designed to work everywhere—without slowing your site down or locking you into a specific framework.

### What’s New?

- Faster loading and smaller bundle size
- A modern installation method using native web components
- Automatic Help Center integration
- AI answers powered by your own content
- Global CDN delivery for consistent performance worldwide

## Automatic Help Center Integration

Once enabled, the chat widget is **automatically injected into your Gately Help Center**—no additional configuration required.

This ensures a consistent support experience across:

- Your Help Center
- Your website or app
- Any external pages where the widget is embedded

You configure it once, and Gately handles the rest.

## AI Answers Powered by Your Content

The widget is powered by **Gately AI**, which generates answers directly from your Help Center articles.

This means:

- AI responses are grounded in your existing documentation
- Answers stay accurate, up to date, and on-brand
- Customers get instant, self-serve support without opening tickets

As you update your Help Center, the AI automatically adapts— **no retraining, syncing, or manual work required**.

## A New, Simpler Installation Method

Getting started now takes **just two lines of code**.

### Simple Embed Code

Add the widget to any website using:

- A lightweight script
- A custom HTML element

### Global CDN Delivery

The widget is served from our global CDN at:

**static-widget-v1.usegately.com**

This ensures fast, reliable loading anywhere in the world.

### Deferred Loading for Better Performance

The script uses the `defer` attribute, so it **never blocks page rendering** or affects your site’s performance.

## Modern Web Component Architecture

The widget is built as a native custom element:

```
<gately-chat-widget></gately-chat-widget>
```

This guarantees:

- Compatibility across frameworks
- No extra SDKs
- No framework lock-in

It works seamlessly with plain HTML, React, WordPress, Shopify, and more.

## Installation Example

```
<script src="https:class="hl-comment">//static-widget-v1.usegately.com/gately-widget.iife.js" defer></script>
<gately-chat-widget project-id="your-project-id"></gately-chat-widget>
```

Once added, the widget automatically initializes and connects to your Gately project.

## Key Improvements

### Faster Loading

- 40% smaller bundle size with an optimized React build

### Better Performance

- Deferred loading ensures the widget doesn’t block initial page render

### Automatic Updates

- Always runs the latest version with new features and fixes

### Improved Stability

- Fixed icon rendering issues, browser edge cases, and layout inconsistencies

### Smarter Configuration

- Widget settings are fetched directly from the Gately API and stay in sync with your dashboard

## Powerful Customization Options

The chat widget is fully configurable—without touching code.

You can customize:

### Appearance

- Colors and branding
- Widget position
- Light or dark themes

### Branding

- Portal name
- Toggle “Powered by Gately” branding
- Custom brand colors

### Messages & Content

- Welcome messages
- Offline messages
- AI response behavior
- Linked Help Center content

### Behavior

- Auto-open rules
- Display conditions
- Mobile behavior

### Features

- AI agent enablement
- Help Center search
- Ticket creation options

## Configuration Attributes

You can also customize the widget directly using HTML attributes:

- **project-id** (required): Your Gately project ID
- **primary-color**: Set a custom brand color
- **portal-name**: Define the widget title
- **show-branding**: Toggle Gately branding
- **ai-agent-enabled**: Enable AI-powered answers

## Platform Support

The new Gately Chat Widget works seamlessly on:

- HTML websites
- React applications
- WordPress sites
- Shopify stores
- Any platform that supports custom HTML

No framework lock-in. No additional SDKs.

## How to Enable and Install the Chat Widget

To enable and configure the chat widget:

1. Go to your Gately dashboard
2. Navigate to **Help Center → Chat Widget**
3. Customize appearance, branding, messages, behavior, and features
4. Copy the installation code provided
5. Paste it into your website or app

You can access the widget settings directly here:

👉 [**HELP CENTER**](https://app.usegately.com/dashboard/help-center/chat-widget)

## Get Started Today

With **automatic Help Center injection** and **AI answers powered by your own content**, the new Gately Chat Widget makes support faster—for both your team and your users.

Enable it today and start delivering smarter, self-serve support everywhere your customers are.