Docs

Changing Your Heroku App Name

Overview

If you need to rename your Heroku app (for example, my-app → my-new-app), let us know first. We’ll place the WAF into transfer mode for the change and take it out of transfer mode once everything is verified.

Note: If you are changing your external domain (e.g., old.example.com to new.example.com), see Changing Your Domain instead — that is a different process.

Steps

  1. Contact support at least 24 hours prior to your application rename so an engineer can set transfer mode for you.
  2. Wait for confirmation that support has placed your WAF into transfer mode.
  3. After confirmation, you’re clear to change the name of the Heroku app in the Heroku dashboard or via heroku apps:rename.
  4. Update the WAF origin to the new .herokuapp.com hostname. Either ask us to update it on the ticket, or use the Origins API endpoint to update it yourself.
  5. Verify from a browser. Load your custom domain in a normal browser session and confirm the site loads. Try it from a mobile device off Wi-Fi as a second check.
  6. Tell us the browser check passed. We take the WAF out of transfer mode.

The whole window from step 2 to step 6 is typically 10–20 minutes.

What to Do If Something Looks Wrong

If your site still isn’t loading correctly after step 5, don’t tell us to exit transfer mode yet — leave the ticket open and let us investigate.

If you renamed the app before opening a ticket, that’s fine — open one now and we’ll get things back to a healthy state and walk through the tail of the procedure with you.

Contact Us