Implementing Email Notifications for Waline Comments

I decided to set up notifications for my Waline comment system to ensure timely responses. While options like WeChat and Telegram exist, I found email to be the most balanced and reliable notification method.

Nov 16, 2025 · 2 min read · 333 Words · -Views -Comments · Programming
Blog Waline 🇨🇳 阅读中文版
Read with AI

Choose an AI assistant

ChatGPT Open in a new tab with the article link and prompt
Claude Copy the prompt, then open Claude

Open Claude
Trouble reading the article?

If the prompt is missing, copy the full prompt below into your AI assistant. If the AI cannot read the article, paste the visible passage you want to discuss and add your question.

I integrated the Waline comment system into my blog a while ago. Recently, I noticed that several readers had left questions on my posts, but because I hadn’t set up notifications, I didn’t see them in time to respond. Since Waline supports various notification methods, I decided to configure email alerts. Here is the process for future reference.

Choosing a Notification Method

WeChat was ruled out because it lacks an official bot API (current solutions are often “hacks”). While Telegram is an option, it can get quite noisy. For a blog, email is a professional and non-intrusive way to stay updated.

Selecting an Email Provider

I decided to use my QQ Mail account. Since it’s only acting as the sender, any reliable provider with a low chance of being flagged as spam will work.

For QQ Mail, you need to generate an Authorization Code from the settings to use as the SMTP password. Note: This is different from your regular login password.

Pro-tip: The same authorization code can be used across multiple clients; for example, I use one code for two separate Waline server instances.

Waline Server Configuration

My Waline server is hosted on Vercel, so I simply added the necessary environment variables to the project settings. After saving, restart the service to apply the changes.

Environment VariableDescription
SMTP_SECURESet to true
SMTP_USERYour email address (e.g., user@qq.com)
SMTP_PASSYour SMTP Authorization Code
SMTP_SERVICEYour provider (e.g., QQ)
SITE_URLThe URL of your blog
SITE_NAMEThe name of your blog

For more advanced options, refer to the official Waline notification guide.

Result

Once configured, you will receive an email like the one below whenever a new comment is posted:

Waline Email Notification Example

Final Thoughts

  1. The email notification feature in Waline is extremely useful for bloggers who want to stay engaged with their readers. I hope future updates bring even more customization options.
  2. For lightweight blogs, Waline remains an excellent, easy-to-configure choice for a commenting system. Kudos to the open-source contributors!

Resources

Authors
Developer, digital product enthusiast, tinkerer, sharer, open source lover