Skip to main content
Last Reviewed: October 31, 2025

Connecting a custom domain to Next.js on Pantheon

During the Alpha stage, reach out to Pantheon staff to connect a custom domain to your Next.js site.


Information:
Alpha support for Next.js

This documentation describes support for Next.js that is under active development and is available only to customers who have been individually approved as part of our Private Alpha program.

To request access, please reach out to [email protected].

If you are migrating an existing Next.js site from our Front-End Sites offering please see our guide on migrating from Front-End Sites.

Please reach out to Pantheon staff through the communication channels of the Alpha program for assistance with connecting custom domains to Next.js sites. Sites on Pantheon generally require moving from an unpaid "Sandbox" plan to a paid plan before connecting a custom domain name through the dashboard. However, in the Alpha phase we have not yet implemented self-service mechanism for moving Next.js sites between plans.

Once Pantheon staff have enabled the capacity to connect a custom domain name to your Next.js site, you can follow the same instructions as for WordPress and Drupal sites: Connecting a Custom Domain to Pantheon. As with any switching of DNS records, the amount of testing you choose to do before switching will depend on the risk tolerance of your organization and the nature of your site. For fully thorough testing, you may want to modify your local hosts file to point your custom domain to the IP address of the new Live environment using these instructions.