Pages New Feature Launch: Preview Deployments for Safe Testing

We're excited to bring you Preview Deployments on Pages! This new feature lets you safely test and preview your code changes before they go live. Now you can catch issues early instead of in production.

What are Preview Deployments?

Preview Deployments give you the power to test code changes safely before they reach your users. When you're working on any non-main branch—feature branches, bug fixes, or experimental changes—Preview Deployments automatically create temporary, isolated environments where you can see your work in action.

Instead of deploying directly to production and hoping for the best, Preview Deployments let you see, test, and share your changes in a safe environment that mirrors your live site exactly.

Here's what makes this workflow so powerful:

• Independent Environment: Each preview deployment has its own dedicated temporary URL (like yourproject-abcdef1234.edgeone.app), completely isolated from your production site (yourproject.edgeone.app).
• Automatic Triggering: Simply push code to designated preview branches, and Pages automatically triggers the build and deployment process without any additional manual operations.
• Easy Sharing: Generated preview URLs can be easily shared with team members, designers, or product managers for quick feedback collection, accelerating code review and testing processes.

How to Use Preview Deployments?

Getting started with Preview Deployments is surprisingly simple—you'll be up and running in just a few minutes. Here's how to set it up:

First, enable the feature. Head to your Pages Console, select your project, and navigate to Project Settings. In the Git Management section, you'll find the option to enable preview branches.

Next, tell Pages which branches to watch. Enter the branch names you want to trigger previews. You can be specific (like development) or use wildcards (like feature/* to catch all your feature branches). This flexibility means you can tailor the setup to match your team's workflow perfectly.

Now comes the magic—just push your code. When you push changes to any configured branch, Pages automatically detects the update and starts building your preview. No buttons to click, no manual deployments to trigger.

Finally, grab your preview link. Once the build completes, check your project's Deployment section to find the new preview deployment. Each one gets its own unique URL that you can immediately start using for testing and sharing.

That's it! Your preview environment is live and ready for testing, feedback, or whatever comes next in your workflow.

What Does This Look Like in Action?

Let's walk through a real scenario. Say your main project lives at yourproject.edgeone.app and your production code sits in the main branch. Everything pushed to main automatically updates your live site—standard stuff.

Now you're working on a new feature in a development branch. In the old days, you'd have to deploy it directly to production to test and validate your changes (risky!). With Preview Deployments, you simply push your development branch changes as usual.

Pages immediately springs into action, building your preview and assigning it a unique URL like yourproject-abcdef1234.edgeone.app. Within minutes, you can visit this link to see your new feature running in an environment identical to production. Your main site? Completely untouched.

Share that preview URL with your designer to get feedback on the new layout, send it to your product manager to confirm the feature works as expected, or use it yourself to test edge cases. Everyone can interact with the real thing, not just screenshots or descriptions.

Get Started

Preview Deployments make risky deployments a thing of the past. With safe testing environments automatically created for every branch, you can test changes without risk, get feedback from your team, and deploy with peace of mind.

Jump into your Pages Console and enable Preview Deployments now. If you have any questions or suggestions during use, please feel free to contact us at any time.