Mailchimp Integration - Docs

Overview

Mailchimp integration is included FREE with every HashBar plan. Automatically capture emails from your announcement bars and popup campaigns, then add subscribers directly to your Mailchimp lists. This integration allows you to build your email list while promoting your products and services.

What You Can Do

With Mailchimp Integration

Capture Emails: Add email collection forms to bars and popups
Auto-Subscribe: Automatically add emails to your Mailchimp audience
Customize Behavior: Set double opt-in, tags, and list assignments
Segment Subscribers: Tag subscribers for easy segmentation in Mailchimp
Suppress Duplicates: Avoid adding existing subscribers again
Test Integration: Verify setup with test emails before going live

Integration Benefits

No Cost: Included with all HashBar plans
Two-Way Sync: Changes in Mailchimp reflect in HashBar
Reliability: Thousands of successful integrations
Security: Industry-standard API authentication
Support: Full documentation and troubleshooting

Getting Started with Mailchimp

Prerequisites

Active Mailchimp account (free or paid)
At least one audience/list created in Mailchimp
Mailchimp API key (we'll show you how to get this)
HashBar plugin installed on your WordPress site

Creating a Mailchimp Account

If you don't have a Mailchimp account yet:

Go to mailchimp.com
Click Sign Up
Enter your email and create a password
Verify your email address
Complete your profile information
Create your first audience/list

Mailchimp offers a free plan for up to 500 contacts and 1,000 emails per month, perfect for getting started.

Obtaining Your Mailchimp API Key

Step-by-Step API Key Setup

Log in to your Mailchimp account
Click your profile icon in the top right corner
Select Account from dropdown menu
In the left sidebar, click Extras → API Keys
Scroll down to Your API Keys section
Click Create A Key button
A new API key will be generated
Copy the API key (click the copy icon or select and copy)
Keep this key safe - don't share it publicly

Identifying Your Mailchimp Server

Your API key contains your server prefix (us1, us2, eu1, etc.):

Example API Key: abc123def456-us1
The part after the last hyphen is your server code
HashBar will use this automatically when you paste your key

Connecting HashBar to Mailchimp

Integration Setup in HashBar

Log in to HashBar dashboard
Navigate to Settings or Integrations
Find Mailchimp Integration section
Click Connect to Mailchimp button
Paste your Mailchimp API key in the field that appears
Click Authenticate or Verify Key
You should see: "Successfully connected to Mailchimp"
Your available Mailchimp audiences will now appear
Click Save to complete setup

Selecting Your Audience/List

After connecting your API key:

A dropdown menu showing all your Mailchimp audiences appears
Select the audience where emails should be added
If you have multiple audiences, you'll select later per campaign
Click Select Audience to confirm

Adding Email Collection to Bars and Popups

Enable Email Capture Form

To capture emails in your announcement bars or popups:

Create or edit a bar or popup
Go to Content or Form section
Enable Email Subscription Form
Configure form settings:
- Form Type: Email only or email + name
- Placeholder Text: "Enter your email" or customize
- Button Text: "Sign Up", "Join Now", "Subscribe", etc.
- Success Message: "Thanks for subscribing!" or custom
Find Mailchimp Settings section
Select which audience to add subscribers to

Mailchimp Form Configuration

Setting	Options	Description
Target Audience	Any of your Mailchimp lists	Which audience to subscribe people to
Double Opt-In	Enable / Disable	Require email confirmation before subscribing
Add Tags	Custom tags/labels	Tag subscribers for segmentation (Pro)
Marketing Permissions	Yes / No / Required	Request consent for marketing emails
Duplicate Handling	Auto-detect existing	Skip if email already in list

Double Opt-In vs Single Opt-In

Single Opt-In (Default)

Process: User enters email → immediately added to list
Speed: Instant subscription
Pros: More subscribers, faster list growth
Cons: Higher bounce rate, lower quality
Best For: High volume, engagement-focused campaigns

Double Opt-In

Process: User enters email → receives confirmation email → clicks link → added to list
Speed: Takes 1-2 minutes (or longer if user delays)
Pros: Higher quality subscribers, lower bounce, better compliance
Cons: Fewer final subscribers (some don't confirm)
Best For: Quality-focused, high-value subscriber lists
Compliance: Required in many EU countries (GDPR)

Choosing Your Setting

E-commerce: Single opt-in for volume, but monitor bounce rates
B2B: Double opt-in for quality leads
EU Audience: Double opt-in (GDPR requirement)
High-Value: Double opt-in for engaged subscribers
Large List: Single opt-in initially, clean list with double opt-in later

Using Tags for Segmentation

What Are Tags?

Tags are labels you add to subscribers in Mailchimp, allowing you to segment your email list:

Example Tags: "signup-bar", "newsletter-popup", "flash-sale"
Use: Send different emails to different tag groups
Tracking: See which campaigns bring in best subscribers

Setting Up Tags (Pro Feature)

Create or edit your bar/popup
In Mailchimp settings, find Add Tags field
Enter one or more tags (comma-separated):
- "newsletter-signup" for newsletter bars
- "vip-offer" for VIP popups
- "flash-sale-2024" for campaigns
All subscribers from this bar/popup get these tags automatically
In Mailchimp, segment by tag to send targeted emails

Tag Strategy

Campaign-Specific: Tag with campaign name ("black-friday-2024")
Offer-Based: Tag with offer type ("15%-discount", "free-shipping")
Interest-Based: Tag by product category ("apparel", "electronics")
Behavior-Based: Tag by action ("email-only", "cart-abandoned")
Source-Based: Tag bar vs. popup ("announcement-bar", "popup-campaign")

Marketing Permissions and GDPR Compliance

Marketing Permission Consent

Add explicit marketing consent to your forms:

Checkbox: "I want to receive marketing emails"
Required: User must check to subscribe
Displayed: Shows in email forms on bars/popups
Tracked: Mailchimp records consent timestamp

GDPR Compliance

Double Opt-In: Recommended for GDPR compliance
Explicit Consent: Marketing permission checkbox is important
Privacy Notice: Link to your privacy policy in form
Data Storage: Ensure you document consent legally
Unsubscribe: Mailchimp handles unsubscribe links automatically

Mailchimp Privacy Policy

Always include a link to your privacy policy:

In your bar/popup form, add text below the email field
Link to your privacy policy (e.g., yoursite.com/privacy)
Example text: "By subscribing, you agree to our Privacy Policy"
Make text small but readable

Step-by-Step Configuration Example

Setting Up a Newsletter Signup Bar

Create Bar: New announcement bar
Content: "Subscribe to our newsletter for tips and updates!"
Form Type: Email only (not name)
Button Text: "Subscribe"
Success Message: "Thanks for subscribing! Check your email."
Double Opt-In: Enabled (required for compliance)
Audience: "Main Newsletter List"
Tags: "newsletter-bar, homepage-signup"
Marketing Consent: Enabled with checkbox
Privacy Link: Added to form
Save & Publish: Make bar live

Verification

Test the form on your live website
Enter a test email address
Click subscribe
Check your email for confirmation (if double opt-in enabled)
Confirm subscriber appears in Mailchimp audience
Verify tags are applied in Mailchimp

Troubleshooting Mailchimp Integration

Connection Issues

Error: "Invalid API Key"

Check: Verify you copied the entire API key
Solution: Generate a new API key in Mailchimp and try again
Verify: API key should be at least 30+ characters

Error: "Could not connect to Mailchimp"

Check: Is your Mailchimp account active?
Check: Do you have internet connection?
Solution: Logout and login to HashBar, try again
Contact: If problem persists, contact support

Subscribers Not Appearing

Emails Not Added to Mailchimp List

Check: Is Mailchimp audience selected in form settings?
Check: Is the bar/popup actually active and published?
Check: Are emails even being submitted? (check browser console)
Check: Wait 5-10 minutes - sync can take a moment
Check: If double opt-in enabled, is user confirming email?
Solution: Test with your own email address

Subscribers Showing as Unsubscribed

Reason: Email already in list as unsubscribed
Solution: Delete from list in Mailchimp, try subscribing again
Or: Create new audience/list for fresh subscribers

Double Opt-In Issues

Users Not Receiving Confirmation Email

Check: Is double opt-in enabled in Mailchimp?
Check: Check spam folder for confirmation email
Check: Verify email address was entered correctly
Solution: Resend confirmation from Mailchimp

Confirmation Email Going to Spam

Solution: Switch to single opt-in for testing
Solution: Check Mailchimp confirmation email template
Solution: Whitelist emails from confirmation sender

Performance Issues

Form Submission Takes Too Long

Check: Mailchimp API response time (usually instant)
Check: Your internet connection speed
Solution: Try from different network/location

Occasional Sync Failures

Normal: Rare failures happen occasionally in any integration
Solution: Emails are usually retried automatically
Solution: Check Mailchimp directly for missing subscribers

Advanced Features

Merge Fields

Available: Map bar form fields to Mailchimp merge fields
Example: "Name" field maps to FNAME (first name) in Mailchimp
Use: Enables personalization in Mailchimp email campaigns
Contact Support: For custom merge field setup

Automation Workflows

Create Automation: In Mailchimp, set up email sequences when subscribed
Example: Send welcome email 1 hour after signup
Example: Send product recommendations after 3 days
Documentation: See Mailchimp automation docs

Best Practices for Email Growth

Optimize Form Copy

Headline: "Get exclusive deals and tips" not just "Subscribe"
Value Prop: Clearly state what they'll get
Button Text: Action-oriented ("Join Now" vs. "Submit")
Trust Signals: "No spam, unsubscribe anytime"

Grow Your List

Multiple CTAs: Use both bars and popups for signups
Timing: Exit-intent popups capture leaving visitors
Incentive: Offer discount or freebie for signup
A/B Test: Test different headlines and CTAs
Target Strategically: Show to guests, not existing customers

List Maintenance

Clean List: Regularly remove bounced addresses in Mailchimp
Inactive Removal: Archive subscribers who haven't engaged in 1 year
Reactivation: Run campaigns to re-engage inactive subscribers
Monitor Health: Check bounce rate and unsubscribe trends