Docs

Carrd Integration Guide

Add Heyo live chat to your Carrd landing page. Perfect for solo founders and quick MVPs.

This guide shows you how to add Heyo to your Carrd landing page.

Prerequisites

You need Carrd Pro (any tier) to add custom embeds.

Installation

Step 1: Add an Embed Element

  1. In your Carrd editor, click the + button to add an element
  2. Select Embed from the menu
  3. Choose Code as the embed type

Step 2: Paste Heyo Code

In the embed code box, paste:

<script src="https://heyo.so/embed/script" defer data-project-id="YOUR_PROJECT_ID"></script>

Step 3: Configure the Embed

  • Style: Set to Hidden (the chat button will still appear)
  • Position: Doesn't matter since it's hidden
  • Click Done

Step 4: Publish

Click Publish to make your changes live. The chat widget will now appear on your landing page!

Best Practices

Placement

Since the embed is hidden, you can place it anywhere on your page. Common practice:

  • At the top of the page (loads early)
  • At the bottom of the page (doesn't interfere with design)

Multiple Carrd Sites

If you have multiple Carrd landing pages:

  • Use the same Project ID for consistent conversations across all pages
  • Or create separate Heyo projects for each landing page to segment conversations

Advanced Usage

Custom Trigger Button

Create a button that opens the chat:

  1. Add a Button element in Carrd
  2. Set the button link to #heyo
  3. Add this in your embed code:
<script src="https://heyo.so/embed/script" defer data-project-id="YOUR_PROJECT_ID"></script>
<script>
document.addEventListener('DOMContentLoaded', function() {
  // Hide default chat button
  const style = document.createElement('style');
  style.textContent = '#heyo-widget-button { display: none !important; }';
  document.head.appendChild(style);
  
  // Custom button trigger
  const buttons = document.querySelectorAll('a[href="#heyo"]');
  buttons.forEach(button => {
    button.addEventListener('click', function(e) {
      e.preventDefault();
      window.HEYO?.show();
    });
  });
});
</script>

Match Your Landing Page Design

  1. Go to Heyo dashboard > Project Settings > Appearance
  2. Customize colors to match your Carrd color scheme
  3. Choose position (usually bottom-right for landing pages)

Responsive Design

Heyo is automatically responsive. It will work perfectly on mobile devices visiting your Carrd landing page.

A/B Testing

If you're A/B testing different versions of your landing page:

  • Use the same Heyo project on both versions to track all conversations
  • Or use different projects to see which version generates more chat engagement

Use Cases

Lead Generation

Answer visitor questions in real-time to convert more sign-ups:

  • Respond quickly to objections
  • Help visitors understand your offer
  • Build trust by being available

Product Validation

Chat with visitors to validate your product idea:

  • Ask what features they need
  • Understand their pain points
  • Get immediate feedback

Event Registration

Help people register for your event or webinar:

  • Answer questions about date/time
  • Clarify what's included
  • Address concerns about attending

Troubleshooting

Chat widget not appearing

  • Verify you have Carrd Pro (any tier)
  • Check that Project ID is correct
  • Ensure embed is published (click Publish button)
  • Clear browser cache and reload

Embed not saving

  • Make sure you're using the Code embed type, not URL
  • Check that you've clicked Done after pasting code
  • Try removing and re-adding the embed

Widget appearing twice

  • Check you haven't added multiple embed elements with the same code
  • Ensure you only have one Heyo embed on the page

Custom button not working

  • Verify button link is set to #heyo
  • Check JavaScript console for errors
  • Make sure embed code includes the custom button script

Carrd Pro Tiers

Heyo works with all Carrd Pro tiers:

  • Pro Lite - ✅ Works (1 custom domain)
  • Pro Standard - ✅ Works (3 custom domains)
  • Pro Plus - ✅ Works (10 custom domains)

Carrd Features Compatibility

Works alongside all Carrd features:

  • Forms (Heyo provides additional way to connect)
  • Custom domains
  • All element types
  • Responsive breakpoints
  • Carrd analytics

Next Steps