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

# Lindy Embed

> Embed Lindy onto your website as a popup or an iFrame

<div style={{ display: 'flex', justifyContent: 'center', margin: '2rem 0' }}>
  <div className="video-card">
    <video src="https://mintcdn.com/lindyai/D9TqHMLRoGnnvrcz/lindy-brand-assets/LIndy_embed_add_trigger_first_video.mp4?fit=max&auto=format&n=D9TqHMLRoGnnvrcz&q=85&s=fad169ed50d16ce4fc6d3ab0db9990fb" width="600" autoPlay muted loop playsInline style={{ display: 'block', width: '100%', borderRadius: '16px' }} data-path="lindy-brand-assets/LIndy_embed_add_trigger_first_video.mp4" />
  </div>
</div>

## Customize Your Chatbot For Your Website

Select the "Lindy Embed" trigger in the flow editor. Click Configure Embed Settings.

<Frame>
  <img src="https://mintcdn.com/lindyai/XRHjWZiSf5VPQvY1/lindy-brand-assets/initial_embed%20_set_up_first_imge.png?fit=max&auto=format&n=XRHjWZiSf5VPQvY1&q=85&s=a85d171dfbc6dd152a85017bff6667ca" alt="Lindy Embed trigger in flow editor with Configure Embed Settings button highlighted" style={{ borderRadius: '8px', border: '1px solid #E5E7EB' }} width="2262" height="1258" data-path="lindy-brand-assets/initial_embed _set_up_first_imge.png" />
</Frame>

You'll see several options to customize your chatbot:

**Domain Name:** Restrict where your Lindy can be embedded. Leave it empty to use on any domain, or enter a specific domain like "yourcompany.com".

**Display Name:** Set the name of your bot as it will appear to users. For example, "Technical Interview Assistant" or "Customer Survey Bot".

**Accent Color:** Choose a color that matches your brand for the top of the chatbot window.

**Popup or iFrame:** Decide between a floating popup chatbot or a fixed iFrame embedded directly in your page.

**Logo:** Upload your company or project logo to appear in the top left of the expanded chatbot.

**Icon:** Select an icon for your chatbot's collapsed bubble.

**Greeting Message:** The introductory message the user sees when they start a chat.

**Conversation Starters:** Customize messages next to your bot to prompt engagement.

**Callout message:** Create a prompt to encourage users to interact with your chatbot.

<div style={{ display: 'flex', justifyContent: 'center', margin: '2rem 0' }}>
  <div className="video-card">
    <video src="https://mintcdn.com/lindyai/6m-Rdk3yJVAHqZQC/lindy-brand-assets/lindy_embed_config_screen_popup.mp4?fit=max&auto=format&n=6m-Rdk3yJVAHqZQC&q=85&s=fe6cd81d54734cc8b3f98fca1540da02" width="600" autoPlay muted loop playsInline style={{ display: 'block', width: '100%', borderRadius: '16px' }} data-path="lindy-brand-assets/lindy_embed_config_screen_popup.mp4" />
  </div>
</div>

## Access The Popup Code Snippet

Select the "Lindy Embed" trigger in the flow editor. Click Configure Embed Settings.

Ensure you have the popup tab selected and copy the "Code Snippet" to your clipboard.

<Frame>
  <img src="https://mintcdn.com/lindyai/6m-Rdk3yJVAHqZQC/lindy-brand-assets/lindy_embed_popup_code_snippet.png?fit=max&auto=format&n=6m-Rdk3yJVAHqZQC&q=85&s=88a717ed36c9b261df1c2a4dbb9bdb2a" alt="Embed settings showing the code snippet to copy for website integration" style={{ borderRadius: '8px', border: '1px solid #E5E7EB' }} width="1916" height="1600" data-path="lindy-brand-assets/lindy_embed_popup_code_snippet.png" />
</Frame>

Paste the code snippet into your website's header.

We offer instructions on how to do so for the most popular platforms:

### Webflow

1. Access your Site Settings.
2. Navigate to "Custom Code".
3. Paste the Code Snippet at the bottom of your "Head Code" section.
4. Publish your changes!

### Wix

1. Choose the site you want to embed Lindy on and click Settings.
2. Scroll down until you see Custom Code.
3. You will see an option in the top right corner to Add Custom Code.
4. Click this and paste your Lindy Code Snippet here.
5. Click Apply.

### Squarespace

1. Access your Site Settings then click Advanced.
2. Select Code Injection.
3. Paste your Lindy Code Snippet into the Header section.
4. Remember to Save and Publish your changes.

### WordPress

1. Install and activate the free Insert Headers and Footers plugin by WPCode.
2. In your WordPress dashboard, navigate to Code Snippets → Header & Footer.
3. Paste the Lindy Code Snippet into the Header box.
4. Click Save Changes.

## Embedding Lindy as an iFrame

You can also embed Lindy as an iFrame.

On the Configure Embed Settings modal, select the iFrame tab and copy the code snippet to your clipboard. You can then paste this code anywhere your website builder accepts iFrames.

<div style={{ display: 'flex', justifyContent: 'center', margin: '2rem 0' }}>
  <div className="video-card">
    <video src="https://mintcdn.com/lindyai/6m-Rdk3yJVAHqZQC/lindy-brand-assets/lindy_export_embed_iframe.mp4?fit=max&auto=format&n=6m-Rdk3yJVAHqZQC&q=85&s=db84e2e50b5ed99a1c657e86165fed8f" width="600" autoPlay muted loop playsInline style={{ display: 'block', width: '100%', borderRadius: '16px' }} data-path="lindy-brand-assets/lindy_export_embed_iframe.mp4" />
  </div>
</div>

When embedding Lindy as an iFrame, it is important to set the height on the element containing the Embed iFrame.

You can also change the height property of the iFrame itself to a specific pixel value (e.g., 100px, 500px) instead of using "100%".

<Note>
  When using iFrame embedding, ensure your container element has a defined height. The iFrame will inherit the height of its container, so setting this correctly is crucial for proper display.
</Note>

## Testing Your Embed

Before deploying your Lindy Embed to production, it's essential to test the chatbot functionality and user experience.

<Frame>
  <img src="https://mintcdn.com/lindyai/XRHjWZiSf5VPQvY1/lindy-brand-assets/lindy-embed-testing-1.png?fit=max&auto=format&n=XRHjWZiSf5VPQvY1&q=85&s=8f31eedbb2c5708324748a151383b2fe" alt="Lindy Embed testing interface showing the preview and test conversation options" width="3278" height="1456" data-path="lindy-brand-assets/lindy-embed-testing-1.png" />
</Frame>

After sending a test message, return to the test panel and click the incoming message to continue the conversation.

<Frame>
  <img src="https://mintcdn.com/lindyai/XRHjWZiSf5VPQvY1/lindy-brand-assets/lindy-embed-test-msg.png?fit=max&auto=format&n=XRHjWZiSf5VPQvY1&q=85&s=b85853445002ceecba4b9790ef03b15f" alt="Lindy Embed testing interface showing the incoming message to select" width="798" height="732" data-path="lindy-brand-assets/lindy-embed-test-msg.png" />
</Frame>

### Preview Your Chatbot

Use the "Click here to preview your Lindy Embed and start a test conversation" link in the configuration panel to test your chatbot in a realistic environment. This allows you to:

* Verify the visual appearance matches your brand
* Test conversation flows and responses
* Check knowledge base integration
* Validate escalation workflows

<div style={{ display: 'flex', justifyContent: 'center', margin: '2rem 0' }}>
  <div className="video-card">
    <video src="https://mintcdn.com/lindyai/XRHjWZiSf5VPQvY1/lindy-brand-assets/lindy-emebed-testing-example.mp4?fit=max&auto=format&n=XRHjWZiSf5VPQvY1&q=85&s=68de1e8578d1a4790e027fabfb2b3a81" width="600" autoPlay muted loop playsInline style={{ display: 'block', width: '100%', borderRadius: '16px' }} data-path="lindy-brand-assets/lindy-emebed-testing-example.mp4" />
  </div>
</div>

### Monitor Chatbot Conversations

<Frame>
  <img src="https://mintcdn.com/lindyai/XRHjWZiSf5VPQvY1/lindy-brand-assets/lindy-embed-view-chatbot-flow.png?fit=max&auto=format&n=XRHjWZiSf5VPQvY1&q=85&s=f577806ae606ba5aabad60f075d9fa60" alt="Lindy Embed chatbot flow monitoring showing conversation logs and user interactions" width="3278" height="1740" data-path="lindy-brand-assets/lindy-embed-view-chatbot-flow.png" />
</Frame>

Track user interactions and monitor conversation quality through the flow view. This helps you:

* Analyze user questions and interaction patterns
* Identify knowledge gaps or areas for improvement
* Monitor escalation triggers and response quality
* Optimize conversation starters and greeting messages

## Best Practices

* **Test on Multiple Devices**: Ensure your embed works well on desktop, tablet, and mobile
* **Match Your Brand**: Use your brand colors and logo for a cohesive experience
* **Clear Purpose**: Make the chatbot's purpose obvious through the display name and greeting
* **Domain Security**: Always specify allowed domains for production sites
* **Performance**: Monitor loading times and optimize as needed

## Troubleshooting

<AccordionGroup>
  <Accordion title="Widget not appearing on my website">
    * Verify the code snippet is placed in the correct location (usually `<head>` section)
    * Check browser console for JavaScript errors
    * Ensure your domain matches the domain restriction if set
    * Clear browser cache and try again
    * Make sure the Lindy agent is published and active
  </Accordion>

  <Accordion title="iFrame height issues">
    * Set explicit height on the container element
    * Use pixel values instead of percentages for better control
    * Test different heights to find optimal size
    * Consider responsive breakpoints for mobile devices
  </Accordion>

  <Accordion title="Styling conflicts">
    * Use more specific CSS selectors if needed
    * Consider using the iFrame option for complete style isolation
    * Check for z-index conflicts with other page elements
  </Accordion>

  <Accordion title="Code snippet not copying">
    * Try using a different browser
    * Copy the code manually by selecting all text
    * Ensure JavaScript is enabled in your browser
    * Check if browser extensions are blocking functionality
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Test Panel" href="/testing/test-panel" icon="play">
    Test your embedded agent before going live
  </Card>

  <Card title="Agent Steps" href="/fundamentals/lindy-101/ai-agents" icon="brain-circuit">
    Fine-tune your agent's behavior and responses
  </Card>

  <Card title="Knowledge Base" href="/fundamentals/lindy-101/knowledge-base" icon="database">
    Enhance your agent with specific knowledge
  </Card>

  <Card title="Monitoring Your Agents" href="/testing/monitoring-your-agents" icon="magnifying-glass">
    Track usage and optimize your embed
  </Card>
</CardGroup>
