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, so widget behavior still updates centrally and the plugin itself never needs a release to pick up a change.
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.
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).
2
Go to Plugins → Add Plugin
In your WordPress admin, go to Plugins and click Add Plugin.
Plugins page, with Add Plugin highlighted
3
Click Upload Plugin
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.
Upload form with herman-widget.zip selected
5
Activate the plugin
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.
Herman Widget listed as active in the Plugins page
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.
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.
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.
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; the plugin itself only adds a capability-gated (manage_options) settings page in WordPress admin, and sanitizes the domain and position before saving them.
⌘I
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"plastics.com","description":"Documentation for plastics.com. Find and source materials, put your catalog on your own website, and work customer requests without leaving Outlook.","colors":{"primary":"#054DBD","light":"#AECBFF","dark":"#054DBD"},"logo":{"light":"https://mintcdn.com/digital-plastics-inc/tgq_KihIs-XmgIRZ/logo/light.svg?fit=max\u0026auto=format\u0026n=tgq_KihIs-XmgIRZ\u0026q=85\u0026s=81bdd26ccc46b142120bb5dd3b18d065","dark":"https://mintcdn.com/digital-plastics-inc/tgq_KihIs-XmgIRZ/logo/dark.svg?fit=max\u0026auto=format\u0026n=tgq_KihIs-XmgIRZ\u0026q=85\u0026s=738bef9b52e993e31c6430de7b9e6fca","href":"https://plastics.com"},"favicon":"https://mintcdn.com/digital-plastics-inc/L7zKI4rZaFL1ZmmT/favicon.png?fit=max\u0026auto=format\u0026n=L7zKI4rZaFL1ZmmT\u0026q=85\u0026s=dea6c03e2ec2e6c05cc4c4242b7780ac","navbar":{"primary":{"type":"button","label":"Get Started","href":"/quickstart"}},"fonts":{"family":"Inter"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"digital-plastics-inc","hasAudioNarration":false,"actualSubdomain":"digital-plastics-inc","customDomains":["docs.plastics.com"],"gitSource":{"type":"github","owner":"plastik-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"19f4a42d-6187-4cf1-acce-407a5a5f4c36","liveDeploymentHistoryId":"6ada17ff04241759b3800072","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada17ff04241759b3800072"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ada17ff04241759b3800072","clientVersion":"0.0.3952","searchFilterCounts":[{"language":"default","tag":"Documentation","count":29},{"language":"default","tag":"Merchant Portal","count":24},{"language":"default","tag":"Integrations","count":18},{"language":"default","tag":"MCP for Sellers","count":5},{"language":"default","tag":"Website Embed","count":5},{"language":"default","tag":"Outlook Add-in","count":4},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Website Search","count":3},{"language":"default","tag":"Support","count":2},{"language":"default","tag":"Evaluations","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"integrations/website-embed/wordpress-plugin","slug":"/integrations/website-embed/wordpress-plugin","pageMetadata":{"title":"WordPress Plugin","sidebarTitle":"WordPress Plugin","description":"Install the widget through a small plugin when your site can't accept a pasted script tag.","href":"/integrations/website-embed/wordpress-plugin"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install the widget through a small plugin when your site can’t accept a pasted script tag.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage,Step,Steps,Table,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Most block themes have no template area where you can paste a raw `,_jsx(_components.code,{children:`\u003cscript>`}),` 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 `,_jsx(_components.a,{href:`/integrations/website-embed/setup`,children:`Setup`}),`, so widget behavior still updates centrally and the plugin itself never needs a release to pick up a change.`]}),`\n`,_jsx(Heading,{level:`2`,id:`get-it-running`,children:`Get it running`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Download your plugin`,children:[_jsxs(_components.p,{children:[`From `,_jsx(_components.strong,{children:`Integrations`}),`, in the `,_jsx(_components.strong,{children:`Admin`}),` section, on the `,_jsx(_components.strong,{children:`Website Embed`}),` tile, click `,_jsx(_components.strong,{children:`Deploy`}),`, then switch to the `,_jsx(_components.strong,{children:`WordPress`}),` tab and click `,_jsx(_components.strong,{children:`Download plugin`}),`.`]}),_jsxs(_components.p,{children:[`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 `,_jsx(_components.strong,{children:`domain`}),`, `,_jsx(_components.strong,{children:`panel position`}),`, and `,_jsx(_components.strong,{children:`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.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`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 `,_jsx(_components.a,{href:`#settings`,children:`Settings`}),`).`]})})]}),_jsxs(Step,{title:`Go to Plugins → Add Plugin`,children:[_jsxs(_components.p,{children:[`In your WordPress admin, go to `,_jsx(_components.strong,{children:`Plugins`}),` and click `,_jsx(_components.strong,{children:`Add Plugin`}),`.`]}),_jsx(Frame,{caption:`Plugins page, with Add Plugin highlighted`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-1.png?fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=db0b2bf63116ac9b2c65d267c9bc5bf5`,alt:`The WordPress admin Plugins page with the Add Plugin button highlighted in the top left`,\"data-og-width\":`1400`,width:`1400`,\"data-og-height\":`756`,height:`756`,\"data-path\":`images/wordpress-plugin-step-1.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-1.png?w=280\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=043e2697db4e3446a0c6d2a2df6d3217 280w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-1.png?w=560\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=042b37af445b0c2676e001e6bf2c310d 560w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-1.png?w=840\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=c9712227c253f563fee8166277d3dadc 840w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-1.png?w=1100\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=52179cba594b680c42e8a061da877907 1100w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-1.png?w=1650\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=4837a2fd4d8d1f8eaa12ca5d1c4b83e1 1650w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-1.png?w=2500\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=4d01a1bd25919223d1a3d41fdb5401f9 2500w`})})]}),_jsx(Step,{title:`Click Upload Plugin`,children:_jsx(Frame,{caption:`Add Plugins page, with Upload Plugin highlighted`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-2.png?fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=3f8bb338b07ec81c62bc0288f650c4b9`,alt:`The WordPress Add Plugins page with the Upload Plugin button highlighted, showing a grid of unrelated featured plugins below`,\"data-og-width\":`1400`,width:`1400`,\"data-og-height\":`760`,height:`760`,\"data-path\":`images/wordpress-plugin-step-2.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-2.png?w=280\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=a56bd4521f077b5a8d3270de1996f8d3 280w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-2.png?w=560\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=462ee38c37f6d68a9aae4c4fae11a0ab 560w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-2.png?w=840\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=08d859eda934e3bb325da097d0f800b9 840w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-2.png?w=1100\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=9330b000eec53053f99dd3ae672a3549 1100w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-2.png?w=1650\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=d1ecf27f429e9cb5789e8f486ce8a33d 1650w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-2.png?w=2500\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=aa66407fad34982fc18e786d51311ded 2500w`})})}),_jsxs(Step,{title:`Choose the zip and install`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Choose File`}),`, select the `,_jsx(_components.code,{children:`herman-widget.zip`}),` you downloaded, then click `,_jsx(_components.strong,{children:`Install Now`}),`.`]}),_jsx(Frame,{caption:`Upload form with herman-widget.zip selected`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-3.png?fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=3942664f60a0a207da50c8ef8170b99e`,alt:`The plugin upload form with herman-widget.zip chosen as the file and the Install Now button highlighted`,\"data-og-width\":`1400`,width:`1400`,\"data-og-height\":`759`,height:`759`,\"data-path\":`images/wordpress-plugin-step-3.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-3.png?w=280\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=79ee2adb1b97ddd1d91e1fd2aa524564 280w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-3.png?w=560\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=df351a28cbd23136c1f3c8a991757ce3 560w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-3.png?w=840\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=5f6f153de9cc5420acdc2b8557fb383d 840w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-3.png?w=1100\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=37e387f96b109319158a3bb1483f9820 1100w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-3.png?w=1650\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=c9736827374aa45512353fd8ca906d14 1650w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-3.png?w=2500\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=895d7dab1c6f81544f0717262d8263e8 2500w`})})]}),_jsx(Step,{title:`Activate the plugin`,children:_jsx(Frame,{caption:`Install confirmation, with Activate Plugin highlighted`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-4.png?fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=dc4c7549ab0eb2ce94244aec8766e5bd`,alt:`The plugin installed successfully screen with the Activate Plugin button highlighted`,\"data-og-width\":`1400`,width:`1400`,\"data-og-height\":`760`,height:`760`,\"data-path\":`images/wordpress-plugin-step-4.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-4.png?w=280\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=fc387f272bfe648a25c434cdf686670b 280w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-4.png?w=560\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=1916074c6cc0d118fc5a39b52061ed98 560w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-4.png?w=840\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=f2bfde82025dcaab6331ed7a09527aeb 840w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-4.png?w=1100\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=e96037eaadc95a3672050aaadc22e5da 1100w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-4.png?w=1650\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=04eacf97217f8ec0eea4fb0cd93e6a33 1650w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-4.png?w=2500\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=e37248b6615bdc186a68d9d8096e7641 2500w`})})}),_jsxs(Step,{title:`Done`,children:[_jsx(_components.p,{children:`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.`}),_jsx(Frame,{caption:`Herman Widget listed as active in the Plugins page`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-5.png?fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=f032a4b93412605a210de6d4a00dcf77`,alt:`The WordPress Plugins list showing Herman Widget installed and active, alongside Akismet and Hello Dolly`,\"data-og-width\":`1400`,width:`1400`,\"data-og-height\":`760`,height:`760`,\"data-path\":`images/wordpress-plugin-step-5.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-5.png?w=280\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=5d2974368f57041ed85b6a557b0557db 280w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-5.png?w=560\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=2b72e58b7d89a3ce898b99f9bcf7fb94 560w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-5.png?w=840\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=13ce6f779a993f56a76ad4977d1e6793 840w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-5.png?w=1100\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=e423080395ba6ad627c6242bbbced21e 1100w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-5.png?w=1650\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=05dc98a37e20903b5a52abe95acae852 1650w, https://mintcdn.com/digital-plastics-inc/q3Ti-TazUJhrSI30/images/wordpress-plugin-step-5.png?w=2500\u0026fit=max\u0026auto=format\u0026n=q3Ti-TazUJhrSI30\u0026q=85\u0026s=7ced8a2e9b371ecc7cb81c87e585d47c 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`settings`,children:`Settings`}),`\n`,_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Settings → Herman Widget`}),` to see or change the two values the plugin controls:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Herman domain`})}),_jsxs(_components.td,{children:[`The URL the plugin loads `,_jsx(_components.code,{children:`herman-widget.js`}),` from. Pre-filled with the domain baked in at download. Enter just the host (`,_jsx(_components.code,{children:`acme.demo.plastics.com`}),`); include `,_jsx(_components.code,{children:`http://`}),` and a port only when pointing at a local development instance.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Position`})}),_jsx(_components.td,{children:`Which corner the pill button appears in: bottom right, bottom left, top right, or top left.`})]})]})]}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`removing-it`,children:`Removing it`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`compatibility`,children:`Compatibility`}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.code,{children:`data-position`}),` attribute to its script tag that such tools should preserve, but this has not been verified against every caching plugin.`]}),`\n`,_jsx(Heading,{level:`2`,id:`security-and-data`,children:`Security and data`}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.a,{href:`/integrations/website-embed/security-and-data`,children:`Security and data`}),`; the plugin itself only adds a capability-gated (`,_jsx(_components.code,{children:`manage_options`}),`) settings page in WordPress admin, and sanitizes the domain and position before saving them.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"WordPress Plugin","sidebarTitle":"WordPress Plugin","description":"Install the widget through a small plugin when your site can't accept a pasted script tag.","href":"/integrations/website-embed/wordpress-plugin"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Get it running","slug":"get-it-running","depth":2,"children":[]},{"title":"Settings","slug":"settings","depth":2,"children":[]},{"title":"Removing it","slug":"removing-it","depth":2,"children":[]},{"title":"Compatibility","slug":"compatibility","depth":2,"children":[]},{"title":"Security and data","slug":"security-and-data","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"digital-plastics-inc","siteName":"plastics.com","title":"WordPress Plugin - plastics.com","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-03T16:00:16.254Z","originalFileLocation":"integrations/website-embed/wordpress-plugin.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Install the widget through a small plugin when your site can\u0026#x27;t accept a pasted script tag.\">\u003cmeta data-mint-head name=\"application-name\" content=\"plastics.com\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"WordPress Plugin - plastics.com\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install the widget through a small plugin when your site can\u0026#x27;t accept a pasted script tag.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"plastics.com\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://digital-plastics-inc.mintlify.app/_mintlify/api/og/v2?division=Website+Embed\u0026amp;title=WordPress+Plugin\u0026amp;description=Install+the+widget+through+a+small+plugin+when+your+site+can%27t+accept+a+pasted+script+tag.\u0026amp;theme=83583c4edb56dade21d0fe1e\u0026amp;signature=aaaefaf01f5103974b690c620a84e25d213c88658904295cd67acba42119289e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"WordPress Plugin - plastics.com\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install the widget through a small plugin when your site can\u0026#x27;t accept a pasted script tag.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://digital-plastics-inc.mintlify.app/_mintlify/api/og/v2?division=Website+Embed\u0026amp;title=WordPress+Plugin\u0026amp;description=Install+the+widget+through+a+small+plugin+when+your+site+can%27t+accept+a+pasted+script+tag.\u0026amp;theme=83583c4edb56dade21d0fe1e\u0026amp;signature=aaaefaf01f5103974b690c620a84e25d213c88658904295cd67acba42119289e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/digital-plastics-inc/4AzwMcoGx-1ay0Cn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"plastics.com\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#054DBD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/website-embed/wordpress-plugin.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.plastics.com/#organization\",\"name\":\"plastics.com\",\"url\":\"https://docs.plastics.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/digital-plastics-inc/tgq_KihIs-XmgIRZ/logo/light.svg?fit=max\u0026auto=format\u0026n=tgq_KihIs-XmgIRZ\u0026q=85\u0026s=81bdd26ccc46b142120bb5dd3b18d065\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.plastics.com#website\",\"name\":\"plastics.com\",\"url\":\"https://docs.plastics.com\",\"publisher\":{\"@id\":\"https://docs.plastics.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin#webpage\",\"url\":\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin\",\"name\":\"WordPress Plugin\",\"description\":\"Install the widget through a small plugin when your site can't accept a pasted script tag.\",\"dateModified\":\"2026-09-03T16:00:16.254Z\",\"isPartOf\":{\"@id\":\"https://docs.plastics.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Merchant Portal\",\"item\":\"https://docs.plastics.com/merchant-portal/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Integrations\",\"item\":\"https://docs.plastics.com/integrations/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Website Embed\",\"item\":\"https://docs.plastics.com/integrations/website-embed/overview\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"WordPress Plugin\",\"item\":\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin#article\",\"headline\":\"WordPress Plugin\",\"name\":\"WordPress Plugin\",\"description\":\"Install the widget through a small plugin when your site can't accept a pasted script tag.\",\"url\":\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin\",\"mainEntityOfPage\":{\"@id\":\"https://docs.plastics.com/integrations/website-embed/wordpress-plugin#webpage\"},\"dateModified\":\"2026-09-03T16:00:16.254Z\",\"publisher\":{\"@id\":\"https://docs.plastics.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.plastics.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"plastics.com\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"plastics.com","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","icon":"rocket","pages":[{"title":"Welcome to plastics.com","sidebarTitle":"Introduction","href":"/introduction"},{"title":"Quickstart","sidebarTitle":"Quickstart","href":"/quickstart"},{"title":"Account setup","sidebarTitle":"Account Setup","href":"/account-setup"}]},{"group":"Merchant Portal","icon":"store","pages":[{"title":"How the portal and your storefront fit together","sidebarTitle":"Overview","href":"/merchant-portal/overview"},{"title":"Get access","sidebarTitle":"Get access","href":"/merchant-portal/get-access"},{"title":"Preview your storefront","sidebarTitle":"Preview your storefront","href":"/merchant-portal/preview-storefront"},{"title":"Create a test account","sidebarTitle":"Create a test account","href":"/merchant-portal/create-test-account"},{"group":"Evaluations","icon":"clipboard-check","pages":[{"title":"Build an evaluation dataset","sidebarTitle":"Dataset JSON","href":"/evaluations/dataset-json"}]},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/merchant-portal/troubleshooting"},{"group":"Integrations","icon":"puzzle-piece","pages":[{"title":"What you can connect","sidebarTitle":"Overview","href":"/integrations/overview"},{"group":"Outlook Add-in","icon":"envelope-open-text","pages":[{"title":"What the add-in does","sidebarTitle":"Overview","href":"/integrations/outlook/overview"},{"title":"Setup","sidebarTitle":"Setup","href":"/integrations/outlook/setup"},{"title":"Security and data","sidebarTitle":"Security and Data","href":"/integrations/outlook/security-and-data"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/integrations/outlook/troubleshooting"}]},{"group":"Website Embed","icon":"code","pages":[{"title":"What the embed does","sidebarTitle":"Overview","href":"/integrations/website-embed/overview"},{"title":"Setup","sidebarTitle":"Setup","description":"Paste two tags before your closing body tag, or demo the assistant on any page from the browser console.","href":"/integrations/website-embed/setup"},{"title":"WordPress Plugin","sidebarTitle":"WordPress Plugin","href":"/integrations/website-embed/wordpress-plugin"},{"title":"Configuration","sidebarTitle":"Configuration","description":"Branding fields, panel behavior, style isolation, and the JavaScript API for controlling the widget from your own code.","href":"/integrations/website-embed/configuration"},{"title":"Security and data","sidebarTitle":"Security and Data","href":"/integrations/website-embed/security-and-data"}]},{"group":"Website Search","icon":"magnifying-glass","pages":[{"title":"Website Search","sidebarTitle":"Overview","href":"/integrations/website-search/overview"},{"title":"Configure Website Search","sidebarTitle":"Configuration","href":"/integrations/website-search/configuration"},{"title":"Website Search API and UI walkthrough","sidebarTitle":"API and UI","href":"/integrations/website-search/api-and-ui"}]},{"group":"MCP for Sellers","icon":"plug","pages":[{"title":"MCP for sellers","sidebarTitle":"Overview","href":"/integrations/mcp/overview"},{"title":"Set up MCP","sidebarTitle":"Setup","href":"/integrations/mcp/setup"},{"title":"MCP tools and account access","sidebarTitle":"Configuration","href":"/integrations/mcp/configuration"},{"title":"MCP security and data","sidebarTitle":"Security and data","href":"/integrations/mcp/security-and-data"},{"title":"MCP troubleshooting","sidebarTitle":"Troubleshooting","href":"/integrations/mcp/troubleshooting"}]}]}]},{"group":"Support","icon":"life-ring","pages":[{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","href":"/troubleshooting"},{"title":"Frequently asked questions","sidebarTitle":"FAQ","href":"/faq"}]}]}]},"title":"WordPress Plugin - plastics.com","buildId":"dpl_7GUK3ixdQTF3BSNUQYJm8ibGxQWw","deploymentId":"dpl_7GUK3ixdQTF3BSNUQYJm8ibGxQWw","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BUwlkhKf.js","DynamicMarkdown-CCag2O17.js","zoom-image-lightbox-BVI9Chd9.js","PlusIcon-dPxQtROk.js","lightbox-handle-r17bVUz3.js"]}