Skip to main content

ENV Variables

Next.js has robust support for ENV variables. ENV variables are for storing sensitive information like API credentials and global settings. Learn more about ENV Variable support in Next.js.

Important! Never commit .env files into your Git repository!

.env.sample​

This project contains a sample .env file. It's recommended that you add ENV variables to your hosting environment, such as Vercel and pull them down vs. maintaining a local copy.

List of ENV variables​

# Tells Next.js we're in development mode. You do not need a Vercel account for this.
VERCEL_ENV="development"
# Allows Node to work with local, self-signed certificates.
NODE_TLS_REJECT_UNAUTHORIZED="0"
# Your WordPress URL (with or without trailing slash).
WORDPRESS_URL="https://nextjs.wpengine.com/"
# This needs to match the PREVIEW_SECRET_TOKEN constant in wp-config.php. It can be any random string of text.
WORDPRESS_PREVIEW_SECRET="ANY_RANDOM_STRING_OF_TEXT"
# Your WordPress username.
WORDPRESS_APPLICATION_USERNAME="YOUR_WORDPRESS_USERNAME"
# Your WordPress application password. Requires WordPress 5.6 and above. See https://make.wordpress.org/core/2020/11/05/application-passwords-integration-guide/
WORDPRESS_APPLICATION_PASSWORD="YOUR_GENERATED_APPLICATION_PASSWORD"
# Your Algolia index name.
NEXT_PUBLIC_ALGOLIA_INDEX_NAME="YOUR_ALGOLIA_INDEX_NAME"
# Your Algolia application ID.
NEXT_PUBLIC_ALGOLIA_APPLICATION_ID="YOUR_ALGOLIA_APP_ID"
# Your Algolia search only key.
NEXT_PUBLIC_ALGOLIA_SEARCH_ONLY_KEY="YOUR_ALGOLIA_SEARCH_ONLY_KEY"
# The external URL's that your images are hosted on.
# See https://nextjs.org/docs/basic-features/image-optimization#domains
NEXT_PUBLIC_IMAGE_DOMAINS="nextjs.wpengine.com, nextjsdevstart.wpengine.com, nextjswp.test"
# Your Frontend URL.
NEXTAUTH_URL="https://nextjs-wordpress-starter.vercel.app/"
# Your WordPress GraphQL endpoint (optional, will default to "graphql" if not provided).
WORDPRESS_GRAPHQL_ENDPOINT="graphql"

Add ENV Variables to Frontend Hosting​

Eventually, you'll need to add your ENV Variables to your host. The host needs these variables in order to run a build.

List of hosts: