Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/subratomandal/dyeink/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Dyeink includes built-in newsletter functionality, allowing readers to subscribe to your blog via email. Collect subscribers, manage your list, and export contacts to grow your audience.
Subscribers are automatically notified when you publish new posts (when newsletter is enabled), helping you build an engaged audience.

Enabling Newsletters

To enable newsletter functionality:
1

Navigate to Settings

Go to Settings in your admin sidebar
2

Open Basics tab

Click the Basics tab
3

Enable newsletter

Toggle the “Enable Newsletter” switch to ON
4

Save settings

Click Save to activate newsletters
Once enabled, a subscribe form will appear on your blog.

Newsletter Email

When you enable newsletters, the system uses your account email address as the “from” address for notifications. This ensures subscribers recognize emails from you.
The “Sending from” email shown in settings is your account email. Make sure it’s professional and recognizable to your audience.

Subscriber Management

While there’s no dedicated Subscribers page shown in the admin interface, subscriber management is handled through the newsletter system.

How Subscriptions Work

  1. Reader visits your blog - Sees a subscribe form
  2. Enters email - Submits their email address
  3. Subscription created - Added to your subscriber list
  4. Receives notifications - Gets emails when you publish (if enabled)

Subscriber Data

For each subscriber, Dyeink stores:
  • Email address - The subscriber’s email
  • Subscription date - When they subscribed
  • Active status - Whether subscription is active
  • Verified status - Email verification state
Subscriber data is tied to your specific blog. Each Dyeink blog maintains its own separate subscriber list.

Subscribe Form

The subscribe form is automatically added to your blog when newsletters are enabled.

Form Location

The subscribe form typically appears:
  • In your blog’s sidebar
  • At the end of blog posts
  • On your blog’s homepage
The exact placement depends on your blog’s theme and layout.

Form Fields

The subscribe form includes:
  • Email input - For the subscriber’s email address
  • Subscribe button - To submit the subscription
  • Privacy notice - (Optional) Explaining how emails are used

Subscription Flow

1

Reader enters email

Visitor types their email in the subscribe form
2

Form submits

Email is validated and sent to your blog’s backend
3

Confirmation message

Reader sees “Subscribed successfully” or similar message
4

Added to list

Email is added to your subscriber database

Managing Subscribers

Viewing Subscriber Count

You can see your total subscriber count through:
  • The Stats API endpoint (for developers)
  • Database queries (if you have direct access)
  • Future admin interface updates
Check the Dyeink roadmap for upcoming subscriber management features in the admin panel.

Removing Subscribers

Subscribers can be removed:
  1. By the subscriber - Using an unsubscribe link (if implemented)
  2. By you - Through database access or API calls
  3. Automatically - When they mark emails as spam

Subscriber Privacy

Dyeink respects subscriber privacy:
  • Emails are stored securely
  • Only you can access your subscriber list
  • Subscribers can unsubscribe anytime
  • No emails are shared with third parties
Always comply with email marketing laws (GDPR, CAN-SPAM, etc.) when sending newsletters. Include unsubscribe options and respect privacy.

Exporting Subscribers

API Access

You can export your subscriber list via the API:
GET /subscribers
const response = await fetch('/api/subscribers', {
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
});

const { subscribers, total } = await response.json();
Response format:
{
  "subscribers": [
    {
      "id": "123",
      "email": "subscriber@example.com",
      "verified": false,
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 1
}

Manual Export

If you have database access, you can query subscribers directly:
SELECT email, created_at, verified, active
FROM subscribers
WHERE blog_id = 'YOUR_BLOG_ID'
AND active = true
ORDER BY created_at DESC;
Export functionality in the admin panel may be added in future updates. Check the changelog for new features.

Newsletter Best Practices

Make subscribing easy

Place subscribe forms prominently on your blog

Set expectations

Tell subscribers how often they’ll receive emails

Provide value

Send notifications only for quality, relevant content

Allow unsubscribing

Always include an easy way to unsubscribe

Notification Settings

When Are Emails Sent?

When newsletters are enabled, subscribers receive an email:
  • When you publish a new post
  • Immediately after publishing (or shortly after)
Email notifications are triggered by the publish action. Draft saves don’t send emails.

Email Content

Newsletter emails typically include:
  • Post title - The title of your new post
  • Excerpt - A preview of the content
  • Read more link - Link to the full post on your blog
  • Unsubscribe link - To opt out of future emails

Growing Your Subscriber List

Optimization Tips

The best way to gain subscribers is to publish valuable content that makes people want more.
  • Focus on solving problems
  • Provide unique insights
  • Be consistent in quality
Don’t just rely on the sidebar form:
  • Mention it in posts (“Subscribe for more like this”)
  • Add to your social media bios
  • Include in guest posts or interviews
Give people a reason to subscribe:
  • Exclusive content for subscribers
  • Early access to new posts
  • Free resources or downloads
Ensure subscribe forms are easy to find:
  • Place in multiple locations (sidebar, post end, popup)
  • Use contrasting colors for the subscribe button
  • Add clear call-to-action text

Subscriber Engagement

Tracking Engagement

While Dyeink tracks overall views and shares, for detailed email engagement (open rates, click rates), you may need:
  • External email service providers (ESP)
  • Custom analytics integration
  • Newsletter platforms like Mailchimp, ConvertKit, etc.

Improving Engagement

1

Write better subject lines

The post title becomes the email subject - make it compelling
2

Publish consistently

Regular publishing keeps subscribers engaged and expecting content
3

Segment your audience

(Advanced) Send different content to different subscriber groups
4

Ask for feedback

Encourage replies and interaction in your newsletter emails

GDPR Compliance

If you have EU subscribers, ensure:
  • Explicit consent - Clear subscribe action (checkbox, form submission)
  • Purpose clarity - Explain what emails they’ll receive
  • Easy unsubscribe - One-click unsubscribe option
  • Data access - Ability to export or delete subscriber data
You are responsible for complying with email marketing laws in your jurisdiction and your subscribers’ jurisdictions.

CAN-SPAM Act

For US audiences:
  • Include your physical address in emails
  • Don’t use misleading subject lines
  • Provide clear unsubscribe mechanism
  • Honor unsubscribe requests within 10 days

Best Practices

  • Get explicit permission before adding anyone to your list
  • Never buy or rent email lists
  • Keep subscriber data secure
  • Be transparent about what subscribers will receive
  • Make unsubscribing easy and honor requests immediately

Troubleshooting

Possible causes:
  • Newsletter not enabled in settings
  • Email going to spam folder
  • Email service issues
  • Incorrect email address provided
Action: Verify newsletter is enabled, ask subscribers to check spam.
Check:
  • Newsletter is enabled in Settings > Basics
  • You’ve saved the settings
  • Your blog theme supports the subscribe widget
  • Cache has been cleared
This means the email is already subscribed. This is normal and prevents duplicate entries.
  • If subscriber wants to reactivate, they may need to use a special link
  • Or you may need to manually reactivate their subscription
If you need to access subscribers:
  • Use the API endpoint: GET /subscribers
  • Requires authentication
  • Returns JSON list of subscribers
See the API section above for details.

Integrations

Email Service Providers

For advanced newsletter features, you can integrate with:
  • Mailchimp - Popular ESP with automation
  • ConvertKit - Creator-focused email platform
  • Substack - Newsletter-first platform
  • SendGrid - Transactional and marketing emails
Third-party integrations require custom setup and may involve API work or Zapier connections.

Zapier Automation

Connect Dyeink to other tools via Zapier:
  1. Trigger: New subscriber in Dyeink
  2. Action: Add to Google Sheets, Airtable, or ESP
Zapier integration availability depends on Dyeink’s API capabilities and official Zapier app status.

Future Features

Potential upcoming subscriber features:
  • Subscriber management UI - View, search, and remove subscribers in admin panel
  • Export to CSV - One-click export of subscriber list
  • Subscription analytics - Growth charts and engagement metrics
  • Segmentation - Tag subscribers by interests or behavior
  • Custom emails - Send one-off emails to subscribers
Check the Dyeink changelog and roadmap for feature updates.

Next Steps

Create Posts

Publish content to notify your subscribers

Analytics

Track how many people are engaging with your blog

Custom Domains

Professional domains build subscriber trust