Carrd Integration Guide
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
- In your Carrd editor, click the + button to add an element
- Select Embed from the menu
- 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:
- Add a Button element in Carrd
- Set the button link to
#heyo - 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
- Go to Heyo dashboard > Project Settings > Appearance
- Customize colors to match your Carrd color scheme
- 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