# Install Embedded Chatbot

The **Embedded Chatbot** allows you to place your chatbot directly inside any webpage using a simple HTML `<iframe>` snippet. This is ideal for dashboards, support pages, or custom layouts where you want the chatbot to appear inline.

### Access the Embedded Chatbot Installation

1. Log in to your **BotPenguin Dashboard**.
2. Click on Bots from left menu then Select the bot.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FZmLdcxPFEodJeMreFAKp%2Fimage.png?alt=media&#x26;token=8567c327-344f-495d-9263-8d311c493803" alt=""><figcaption></figcaption></figure>

3. Now click on **“Install Your Chatbot.”**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FnySbpv3zBrItfl8rgo6L%2Fimage.png?alt=media&#x26;token=940db384-ae93-4dd1-9f6d-a82ab555c4e3" alt=""><figcaption></figcaption></figure>

4. Select the **Embedded Chatbot** tab from the top menu.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FidlasoCklPZxq9N8Bq1A%2Fimage.png?alt=media&#x26;token=4d5bcff7-582c-43cf-b887-5318e432dbc7" alt=""><figcaption></figcaption></figure>

You will see the installation options for embedding your chatbot into a website.

***

### Get the Installation Code

In the **Get Chatbot Installation Code** section:

1. Copy the iframe code provided.
2. This code is unique to your chatbot.

Example:

```html
<iframe 
  src="https://page.botpenguin.com/XXXXXXXXXXXX" 
  width="100%" 
  height="600" 
  frameborder="0">
</iframe>
```

> 💡 **Tip:** You can adjust the `width` and `height` values to match your page layout.

***

### Add the Code to Your Website

Paste the copied iframe code into the HTML of every page where you want the chatbot to appear.

**Common placements include:**

* Inside the `<body>` tag
* Within a specific container or section
* Embedded inside CMS editors (WordPress, Webflow, etc.)

> ⚠️ Make sure the page allows iframes and does not block third-party embeds.

***

### Share Installation Code with Your Developer (Optional)

If a developer manages your website:

1. Enter their email address in the **Share Installation Code** section.
2. Click **Send Email**.

The developer will receive the installation instructions directly.

***

### Request BotPenguin Installation Support

If you prefer hands-on assistance:

1. Click **Help me in Installing ChatBot**.
2. The BotPenguin support team will handle the installation for you.

***

### Verify the Installation

Once added:

* Reload your webpage
* Confirm the chatbot appears correctly
* Test a conversation to ensure it responds as expected

***

### Troubleshooting

If the chatbot does not appear:

* Confirm the iframe code is pasted correctly
* Check that your website allows external embeds
* Ensure no ad blockers or CSP rules are blocking the iframe

### FAQ's

Here are some common questions asked regarding training with FAQ's:

<details>

<summary>Do I need coding knowledge to install it?</summary>

No. If you can copy and paste HTML code, you can install the embedded chatbot. For advanced customization or CMS setups, a developer may help

</details>

<details>

<summary>Where can I embed the chatbot?</summary>

You can embed the chatbot on:

* Any HTML webpage
* Dashboards or internal tools
* CMS platforms like WordPress, Webflow, or Wix
* Customer support or help pages

</details>

<details>

<summary>Can I change the size of the embedded chatbot?</summary>

Yes. You can modify the `width` and `height` values in the iframe code to fit your page layout.

</details>

<details>

<summary>Will the chatbot work on mobile devices?</summary>

Yes. The embedded chatbot is responsive and works on mobile devices as long as the iframe is placed inside a responsive container.

</details>

<details>

<summary>Can I embed the chatbot on multiple pages?</summary>

Absolutely. You can use the same iframe code on as many pages as you want.

</details>

<details>

<summary>Can I send the installation code to my developer?</summary>

Yes. Use the **Share Installation Code** option to email the iframe code directly to your developer.

</details>

### Support

If you still have questions for our team, write to us at [**support@botpenguin.com**](mailto:support@botpenguin.com). We’ll get back to you within 48 hours.
