Documentation
Learn how to use our newsletter platform to collect subscribers and send beautiful newsletters.
Welcome to the documentation for our newsletter platform. Here you will find all the information you need to start collecting subscribers and sending beautiful newsletters.
Getting Started
Our newsletter platform helps you build and grow your email list with customizable signup forms and send professional newsletters with drag-and-drop templates.
Key Features
- Email Collection Widget: Embeddable signup forms for your website
- Custom Templates: Drag-and-drop template builder
- Rich Text Editor: TipTap-powered content editor with image support
- Subscriber Management: Organize and manage your email list
- Analytics: Track opens, clicks, and subscriber growth
Email Collection Widget
Adding the Widget to Your Website
To start collecting email subscribers, you need to embed our signup widget on your website. Here's how:
1. Get Your Widget Code
- Log into your dashboard
- Navigate to Settings → Widget
- Copy the provided script code
2. Add the Script to Your Website
Add this script tag to your website's HTML, preferably before the closing </body> tag:
<script>
(function(d, s, id) {
var js, fjs = d.getElementsByTagName(s)[0];
if (d.getElementById(id)) return;
js = d.createElement(s); js.id = id;
js.src = "https://debdabe.et/widget.js";
js.setAttribute('data-user-id', 'YOUR_USER_ID');
fjs.parentNode.insertBefore(js, fjs);
}(document, 'script', 'newsletter-widget'));
</script>Replace YOUR_USER_ID with your actual user ID from the dashboard.
3. Display the Widget
Add this HTML element where you want the signup form to appear:
<div id="newsletter-signup" data-style="minimal"></div>Widget Customization
You can customize the widget appearance by adding data attributes:
<div id="newsletter-signup"
data-style="minimal"
data-button-color="#0066cc"
data-placeholder="Enter your email address"
data-button-text="Subscribe">
</div>Available options:
data-style:minimal,card,inlinedata-button-color: Any valid CSS colordata-placeholder: Custom placeholder textdata-button-text: Custom button text
Creating Newsletters
Using the Rich Text Editor
- Navigate to Newsletters → Create New
- Choose a template or start from scratch
- Use the rich text editor to add content:
- Text formatting: Bold, italic, underline, colors
- Images: Upload or paste image URLs (automatically optimized)
- Links: Add clickable links
- Lists: Bullet points and numbered lists
Custom Templates
Create reusable templates with our drag-and-drop builder or custom HTML:
Drag-and-Drop Builder
-
Go to Templates → Create Template
-
Choose "Use Template Builder"
-
Drag elements from the sidebar:
- Content Placeholder: Required
{content}area - Headings: Various heading sizes with customizable styling
- Text blocks: Paragraph content with font and color options
- Images: Visual content (automatically optimized to base64)
- Buttons: Call-to-action buttons with custom colors
- Links: Clickable text links
- Dividers: Section separators
- Content Placeholder: Required
-
Customize each element:
- Styling: Colors, fonts, alignment, sizes
- Content: Text, links, and images
- Layout: Drag to reorder elements
-
Save your template for future use
Custom HTML Templates
For advanced users who need complete design control:
- Choose "Custom HTML" when creating a template
- Write your own HTML/CSS code
- Include required
{content}and{title}placeholders - Use email-safe HTML and inline CSS
- Test thoroughly across email clients
See our Templates Guide for detailed instructions and examples.
Sending Newsletters
- Create or select your newsletter content
- Choose your template
- Preview your newsletter
- Click Send to deliver to all subscribers
Best Practices
Email Collection
- Clear Value Proposition: Tell visitors what they'll receive
- Strategic Placement: Add widgets to high-traffic pages
- Mobile Optimization: Ensure forms work on all devices
- Privacy Compliance: Include privacy policy links
Newsletter Content
- Compelling Subject Lines: Keep them short and engaging
- Mobile-First Design: Most emails are read on mobile
- Image Optimization: Use high-quality, compressed images
- Clear CTAs: Make your call-to-action buttons prominent
Deliverability
- Consistent Sending: Maintain regular sending schedule
- List Hygiene: Remove inactive subscribers
- Authentication: Ensure proper email authentication
- Engagement: Monitor open and click rates
Troubleshooting
Widget Not Appearing
- Check that the script is loaded correctly
- Verify your user ID is correct
- Ensure the target div element exists
- Check browser console for errors
Images Not Displaying
- Images are automatically converted to base64 for email compatibility
- Ensure images are accessible via public URLs
- Check image file sizes (recommended: under 1MB)
Low Deliverability
- Check your sender reputation
- Avoid spam trigger words
- Maintain good list hygiene
- Use double opt-in for new subscribers
Support
Need help? Contact our support team or check our FAQ section for common questions and solutions.