Skip to main content

Migration from Valine

About 3 min...

Since Waline completely reuses Valine's data structure in storage, migrating from Valine to Waline is very simple.

  1. Deploy backend according to Vercel Deploy in Get Started section. LEAN_ID and LEAN_KEY should be the same as those applied for when using Valine before. Don't forget to set LEAN_MASTER_KEY for Waline.

  2. Modify frontend scripts according to HTML in Get Started section. Please remind we should remove old configuration appId and appKey from Valine, and add serverURL option.

    - <script src='//'></script>
    + <script src='//'></script>
    + <link href='//' rel='stylesheet' />
    -  new Valine({
    +  Waline.init({
        el: '#vcomments',
    -   appId: 'Your appId',
    -   appKey: 'Your appKey'
    +   serverURL: 'YOUR SERVER URL'


Waline V2 has removed Valine support and moved to a better configuration. The following is a migration summary of some options:

  • placeholder: use locales.placeholder
  • highlight: use highlighter
  • avatarForce, avatar: use the server's AVATAR_PROXY environment variable
  • recordIP: no longer display the user IP, and provide the DISABLE_USERAGENT environment variable on the server
  • requiredFields: renamed to requiredMeta
  • langMode: renamed to locales
  • emojiCDN, emojiMap: use more powerful emoji options

For waline config, please refer to Client Config. You can also check Waline Client V2 Migration Guide to learn about the options that are not compatible with Valine.

Using Leancloud China

Besides LEAN_ID and LEAN_KEY, you need to config LEAN_SERVER environment variable if you're the user of LeanCloud China.

Also, you need to complete Domain name filing to Local Communications Administration, that needs a Fixed IP。

Migration to Cloudbase

If you want to migrate your Valine data to Tencent Cloud Database, you can use the import function of LeanCloud with the import function of the cloud database. Select Import/Export > Limit to certain classes > Comment > Export in the LeanCloud background, and then you will receive a email notification.

Paste the content of export file into the textarea below, and click the convert button to obtain the file to be imported. Enter the Tencent Cloud Development Backend → Databaseopen in new window page and select the Comment collection. If the collection doesn't exist, click New Collection in the upper left corner to create it. Click the import button above, select the converted file and wait a while to complete importing.

 Storage service

Waline Highlights

Compared with Valine, Waline has the following highlights:

More features

  1. Markdown supports more syntax, including superscript and subscript, emoji, tables, strike-through, mathematical formulas, HTML tags, footnotes, etc.
  2. Image upload feature, which allows customized image provider service or embedding images directly.
  3. The brand new label system adds level labels for users according to the frequency of user interaction, and support custom labels for registered users.
  4. Emoji presets and tab support, allowing multiple sets of Emoji, while allowing anyone to publish and use Emoji presets.
  5. A brand new reaction system that allows visitors to express their attitude towards the article.
  6. Comment likes, express support for the comment you like.
  7. Pageviews, more accurate viewing and anti-tampering.
  8. Emoji search. Customizable service, allowing users to search and insert emoticons freely.
  9. Support registered users to edit and delete their published comments.


  1. Zero privacy leakage, will not expose user mailboxes, IP addresses and other sensitive information, and can choose to hide user geographic location, browser and operating system at server
  2. Complete anti-spam system.
    • All comments can be authenticated by anti-spam services and support additional validation logic.
    • You can set the comment speed limit for a single IP or a single user, and Waline automatically identify duplicate comments.
  3. Comment review feature, in sensitive periods or when the website is under attack, you can enable comment review, manually review and approve the display of comments, and prevent malicious comments from causing site closure.
  4. Support user accounts. Besides registering an account, Waline also supports social media accounts, quickly synchronizes avatars and nicknames with authorized label to prevent identity fraud.

more convenient

  1. Various methods (QQ, WeChat, DingTalk, E-mail), etc. to notify bloggers about comments
  2. Powerful management service, you can view all users and comments and perform related operations, and set custom labels and administrators for users
  3. Front-end management, administrators can review, edit or delete comments directly through the Waline comment component.
TIPS: The comment area is only for demo. If you have any questions, please go to Github Discussion to ask.
What do you think?
  • 0
  • 0
  • 0
  • 0
  • 0
  • 0
  • Latest
  • Oldest
  • Hottest
Powered by Waline v3.1.2