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

# WordPress plugin

> Install the BoundBot WordPress plugin to add the WebChat widget to a WordPress site without manual embed code.

export const BrowserWrapper = ({src, alt, title, description, height = '280px', caption, imgStyle = {}, children, imagePadding = '0px'}) => {
  const legacyDocsImagePrefix = '/images/';
  const productionDocsImagePrefix = '/docs/images';
  const rawSrc = typeof src === 'string' ? src : src && (src.src || src.default) || '';
  const imageSrc = rawSrc.startsWith(legacyDocsImagePrefix) ? `${productionDocsImagePrefix}/${rawSrc.slice(legacyDocsImagePrefix.length)}` : rawSrc;
  return <Frame caption={caption || alt || title} width="100%">
      <div style={{
    border: '1px solid #e2e8f0',
    borderRadius: '12px',
    overflow: 'hidden',
    boxShadow: '0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05)',
    width: '100%'
  }}>
        <div style={{
    backgroundColor: '#f8fafc',
    padding: '10px 15px',
    borderBottom: '1px solid #e2e8f0',
    display: 'flex',
    gap: '6px'
  }}>
          <div style={{
    width: '10px',
    height: '10px',
    borderRadius: '50%',
    backgroundColor: '#ff5f56'
  }} />
          <div style={{
    width: '10px',
    height: '10px',
    borderRadius: '50%',
    backgroundColor: '#ffbd2e'
  }} />
          <div style={{
    width: '10px',
    height: '10px',
    borderRadius: '50%',
    backgroundColor: '#27c93f'
  }} />
        </div>
        <div style={{
    overflow: 'hidden',
    background: '#ffffff',
    width: '100%',
    padding: imagePadding
  }}>
          {src ? <img src={imageSrc} alt={alt || ''} data-docs-screenshot style={{
    ...imgStyle,
    width: '100%',
    minWidth: '100%',
    height: 'auto',
    display: 'block',
    borderRadius: '0px'
  }} /> : children ? children : null}
        </div>
      </div>
    </Frame>;
};

The BoundBot WordPress plugin is the fastest install path when your site runs on WordPress and you want to add WebChat without pasting raw embed code into the theme.

## What the plugin is for

Use the WordPress plugin when you want:

* a simpler install flow for WordPress admins
* a widget deployment path without editing theme files
* a faster handoff to marketing or site operations teams

## Before you install the plugin

Make sure you already have:

* a WordPress site where you can install plugins
* a <a href="https://www.boundbot.com/dashboard/channels/webchat" target="_blank" rel="noopener noreferrer">BoundBot WebChat channel</a>
* the public key for the widget you want to install

## Install the plugin

<Steps>
  <Step title="Download the plugin package">
    Open <a href="https://www.boundbot.com/dashboard/settings/general" target="_blank" rel="noopener noreferrer"><b>Settings</b></a> -> <b>Team settings</b> -> <a href="https://www.boundbot.com/dashboard/settings/integrations" target="_blank" rel="noopener noreferrer"><b>Integrations</b></a> and download the `boundbot.zip` package.

    <BrowserWrapper src="../images/wordpress-plugin-card.png" alt="BoundBot Integrations dashboard showing the WordPress plugin card and download option for the boundbot.zip package." caption="Download the BoundBot WordPress plugin package from the Integrations dashboard." />
  </Step>

  <Step title="Upload it to WordPress">
    In WordPress, go to **Plugins** -> **Add New** -> **Upload Plugin**, then upload `boundbot.zip`.
  </Step>

  <Step title="Activate the plugin">
    Activate the plugin inside WordPress after the upload completes.
  </Step>

  <Step title="Add your BoundBot public key">
    Open the plugin settings in WordPress and enter the BoundBot public key for the WebChat channel you want to use.
  </Step>
</Steps>

## Plugin install vs direct embed

| Method           | Best for                                           |
| ---------------- | -------------------------------------------------- |
| WordPress plugin | Teams managing the site through WordPress admin    |
| Script embed     | Teams that want the simplest direct code install   |
| Iframe embed     | Fixed placement or highly controlled embed layouts |

## Related pages

<CardGroup cols={2}>
  <Card title="WebChat" icon="message-square" href="/channels/webchat">
    Create or review the WebChat channel before you install the plugin.
  </Card>

  <Card title="Embed WebChat" icon="code" href="/developers/embed-webchat">
    Compare the plugin path with direct iframe and script-based embed options.
  </Card>

  <Card title="Team settings" icon="users" href="/guides/team-settings">
    Download the plugin package from the team integrations area.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Follow the shortest path from onboarding to a working website widget.
  </Card>
</CardGroup>

## Common questions

### Do I still need a WebChat channel?

Yes. The plugin is only an install path. The actual widget still depends on a BoundBot WebChat channel and public key.

### When should I skip the plugin?

Skip it when your team already manages the site code directly and prefers the script or iframe embed path from the standard WebChat guide.