> For the complete documentation index, see [llms.txt](https://authentic.gitbook.io/authentic-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://authentic.gitbook.io/authentic-docs/embedding-insurance/add-insurance-to-your-platform/embed-our-widget.md).
# Embed our widget
How to embed the plug and play embedded widget for Authentic Insurance partners.
**Installation**
Add the following script tag to the `` of your `index.html` file.
```html
```
To view the source code go here:
**Usage**
Once installed, the widget script will expose controls to the browser window. You can configure the widget's look and behavior on initialization (see the full `WidgetConfig` definition below).
```html
```
**Note**: We recommend adding UTM parameters to the widget (more information on UTMs can be found [here](/authentic-docs/embedding-insurance/tracking-marketing-utm-params.md)). Partners can do this by adding the UTM parameters as normal onto the insurancePortal url in the widget script. An example would be:
```javascript
portal: { url: 'https://example-tenant-name.prod.authenticinsurance.com&utm_source=tenant-name&utm_medium=widget' },
```
**Configuration**
```ts
interface WidgetConfig {
portal?: {
url?: string;
// The CSS selector for the target element you want the Portal injected into.
// If no target selector is provided, the widget will inject its default persistent banner and modal.
targetSelector?: string;
};
customerId?: string;
prefillData?: {
lead?: {
email:? string;
businessClassCode?: string;
stateCodes?: string[];
productIds?: string[];
};
responses?: {
exposures?: Array<{
exposureName: string;
// Where each key is a field's name mapped to its value (e.g. ['BUSINESS_LEGAL_NAME']: 'Example Business Name');
fieldValues: Record;
}>;
// Same as format described above.
questions?: Record;
};
};
themeOverrides?: {
useDarkMode?: boolean;
primaryColor?: string;
secondaryColor?: string;
borderRadiusPx?: number;
brand?: {
name?: string;
logoUrls?: {
darkBg?: string;
lightBg?: string;
};
faviconUrl?: string;
};
};
};
```