> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plastics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress Plugin

> Install the widget through a small plugin when your site can't accept a pasted script tag.

Most block themes have no template area where you can paste a raw `<script>` tag. The WordPress plugin solves that: it is a thin loader with no widget logic of its own. It enqueues the same hosted script documented in [Setup](https://docs.plastics.com/integrations/website-embed/setup.md), so widget behavior still updates centrally and the plugin itself never needs a release to pick up a change.

## Get it running

**1. Download your plugin**

From **Integrations**, in the **Admin** section, on the **Website Embed** tile, click **Deploy**, then switch to the **WordPress** tab and click **Download plugin**.

The zip is generated for your account at the moment you click download, not a generic file shared across every organization. It bundles your current **domain**, **panel position**, and **auto-open** setting from the Set up step directly into the plugin, so the assistant works immediately on activation with no settings to fill in first.

> [!WARNING]
>
> Those three values are baked in at download time only. If you change the domain, position, or auto-open toggle in the embed admin afterward, the plugin does not pick up the change automatically — download a fresh copy, or update the domain and position by hand in the plugin's own settings page (see [Settings](#settings)).

**2. Go to Plugins → Add Plugin**

In your WordPress admin, go to **Plugins** and click **Add Plugin**.

![The WordPress admin Plugins page with the Add Plugin button highlighted in the top left](https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-1.png?fit=max\&auto=format\&n=q3Ti-TazUJhrSI30\&q=85\&s=db0b2bf63116ac9b2c65d267c9bc5bf5)

Plugins page, with Add Plugin highlighted

**3. Click Upload Plugin**

![The WordPress Add Plugins page with the Upload Plugin button highlighted, showing a grid of unrelated featured plugins below](https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-2.png?fit=max\&auto=format\&n=q3Ti-TazUJhrSI30\&q=85\&s=3f8bb338b07ec81c62bc0288f650c4b9)

Add Plugins page, with Upload Plugin highlighted

**4. Choose the zip and install**

Click **Choose File**, select the `herman-widget.zip` you downloaded, then click **Install Now**.

![The plugin upload form with herman-widget.zip chosen as the file and the Install Now button highlighted](https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-3.png?fit=max\&auto=format\&n=q3Ti-TazUJhrSI30\&q=85\&s=3942664f60a0a207da50c8ef8170b99e)

Upload form with herman-widget.zip selected

**5. Activate the plugin**

![The plugin installed successfully screen with the Activate Plugin button highlighted](https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-4.png?fit=max\&auto=format\&n=q3Ti-TazUJhrSI30\&q=85\&s=dc4c7549ab0eb2ce94244aec8766e5bd)

Install confirmation, with Activate Plugin highlighted

**6. Done**

Because the domain and position are already baked in, the assistant appears on your site as soon as the plugin is active — there is no separate configuration step required.

![The WordPress Plugins list showing Herman Widget installed and active, alongside Akismet and Hello Dolly](https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-5.png?fit=max\&auto=format\&n=q3Ti-TazUJhrSI30\&q=85\&s=f032a4b93412605a210de6d4a00dcf77)

Herman Widget listed as active in the Plugins page

## Settings

Go to **Settings → Herman Widget** to see or change the two values the plugin controls:

| Field | What it does |
| - | - |
| **Herman domain** | The URL the plugin loads `herman-widget.js` from. Pre-filled with the domain baked in at download. Enter just the host (`acme.demo.plastics.com`); include `http://` and a port only when pointing at a local development instance. |
| **Position** | Which corner the pill button appears in: bottom right, bottom left, top right, or top left. |

Saving here overrides the value baked in at download time. The auto-open setting is not exposed on this page — it can only be changed by downloading the plugin again with a different toggle state in the embed admin.

## Removing it

Deactivating the plugin stops the widget from loading on your site. Deleting it through the WordPress admin also removes the domain and position settings it stored, leaving nothing behind.

## Compatibility

The plugin has been tested on WordPress 7.1. It uses WordPress's standard script enqueue and settings APIs rather than any theme-specific hooks, so it is expected to work on both block and classic themes. If your site runs an aggressive caching or JavaScript-optimization plugin, do a full cache clear after installing and confirm the pill button still appears — the plugin adds a `data-position` attribute to its script tag that such tools should preserve, but this has not been verified against every caching plugin.

## Security and data

Installing the plugin does not change what the widget can access or what it collects. It loads the identical hosted script over the identical allowlisted endpoint described in [Security and data](https://docs.plastics.com/integrations/website-embed/security-and-data.md); the plugin itself only adds a capability-gated (`manage_options`) settings page in WordPress admin, and sanitizes the domain and position before saving them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.