← Back to Docs Index

If you’re reading this, you’ve likely already downloaded your did-configuration.json file. Great! You’re just a few steps away from verifying your domain ownership using a Domain Linked Verifiable Credential (DLVC).

This guide will walk you through publishing the file on your website and verifying the setup.

Step 1: Download did-configuration.json

Make sure you’ve saved the file exactly as it was provided – do not modify its contents. This file is cryptographically signed and must remain intact.

You need to rename in did-configuration.json if it has a different filename.

Step 2: Publish the File at the Right Location

You need to make the file publicly accessible at:

https://yourdomain.com/.well-known/did-configuration.json

Note: The .well-known folder must be directly in the root of your domain.

Step 3: Platform-Specific Instructions

WordPress (Classic or Block Theme)

  1. Log in to your WordPress admin panel.
  2. Install the plugin: “File Manager” or use FTP / cPanel.
  3. Navigate to your root directory and create a folder called .well-known (if it doesn’t exist).
  4. Upload the did-configuration.json file inside .well-known.
  5. Visit: https://yourdomain.com/.well-known/did-configuration.json to make sure it loads.

?? If you get a 403 Forbidden or 404 error, continue reading below (troubleshooting section).

WordPress + Elementor or page builders

Same as above – the file upload method does not change. Just ensure:

  • You’re working at the server or file manager level.
  • You’re not uploading this file as media content or trying to embed it in a page.

GitHub Pages

  1. In your repository, create a folder named .well-known in the root.
  2. Place your did-configuration.json inside.
  3. Commit and push.
  4. Verify the file at: https://yourdomain.github.io/.well-known/did-configuration.json

Netlify

  1. In your project folder, create public/.well-known/ and put the file there.
  2. Push your changes and redeploy the site.
  3. Test the file in your browser.

Vercel

  1. Same as Netlify – place the file inside /public/.well-known/.
  2. Deploy your changes.
  3. Test it live.

Common Issues & Troubleshooting

403 Forbidden (especially on Apache servers)

  • This happens when .well-known folders are restricted.
  • Fix: Edit your .htaccess file and add:
<Directory "/.well-known">
    Allow from all
</Directory>

Or simply:

RewriteRule ^\.well-known/ - [L]

404 Not Found

  • Double-check the file path and make sure your hosting provider doesn’t block dotfolders (.well-known).
  • Some CMS platforms like Wix or Shopify do not support custom folders like .well-known. In this case, you’ll need to host the file externally or use a subdomain that you control.

Final Step: Verify

Once the file is live at https://yourdomain.com/.well-known/did-configuration.json, the verification system will automatically detect it and validate your domain.

You’re done!

Need Help?

If you’re stuck or using a non-standard setup, feel free to reach out to our support.

← Back to Docs Index