Migrating Disqus Comments for a Single Post

Sometimes you might change a post’s slug—or, if you use a static site generator for your blog, the post’s filename. Even a tiny change can cause existing Disqus comments to disappear. In this case, you can use the Disqus URL Mapper to restore them.

Here’s a detailed guide.

1. Prepare your URLs

You’ll need:

• Old URL: The exact URL where the comments currently exist
• New URL: The URL where you want the comments to appear

Both URLs must include the full path including the domain (e.g., https://example.com/blog/old-post → https://example.com/blog/new-post)

2. Log in to Disqus Admin

Go to: https://disqus.com/admin/

3. Select your site

From the top menu, choose the site you want to manage.

4. Go to the ‘Migrate Threads’ tool

Navigate to:
Settings → Advanced → Migration Tools → URL Mapper or directly visit: https://disqus.com/admin/tools/migrate/

5. Create a CSV file

You must upload a CSV with the following format:

old_url,new_url 
https://example.com/blog/old-post,https://example.com/blog/new-post

Make sure there are no extra spaces and use the exact URLs.

Save the file as migration.csv.

6. Upload the CSV

Upload the file under the URL Mapper tool.

Disqus will then begin remapping the threads.

7. Wait for propagation

This process might take a few minutes to a few hours. Disqus will transfer the existing comments to the new URL, and any future comments will appear under the new URL.