Managing your bundles
Use the Deployer's Bundles page to manage and deploy code changes for your site.
A bundle in PageBuilder Editor is a .zip file that contains the code, node modules, and environment configurations needed to run your website.
The Deployer's Bundle page helps you upload and preview several bundles before making them live. This allows you to identify errors and make necessary changes before deploying them to your Production environment.
Bundles have three main statuses:
Unused - defines an uploaded bundle that you still need to deploy.
Deployed - defines a server-deployed bundle, allowing you to test how it looks and behaves before promoting it to live.
Live - defines your website's active version, which receives user traffic.
Note
Deployer's maximum total size limit for unzipped bundles is 250MB (262,144,000 bytes). This limit includes both your application bundle and the Engine components.
Since the Engine components require approximately 90MB of the total allocation, your application bundle should not exceed 160MB unzipped to ensure successful deployment.
Prerequisites
You must create a bundle—a .zip file containing all the code needed to run your website—before you can upload it using the Deployer's Bundle page. See Build a bundle locally for more details.
As a developer for a news organization, you want to deploy a new bundle containing custom components into your Production environment. To do so, you create a .zip file—or bundle—of your code locally and then access PageBuilder Editor > Developer Tools > Deployer.
You upload your bundle and give it a descriptive name. This process allows you to deploy your custom components efficiently, ensuring your editorial team can access the new blocks after they're deployed.
Using the Deployer tool, you can also track all your bundle versions and control when they become available in your Production environment. In case you experience any issues with the active bundle, you can easily roll back to a previous working version of your website.
Procedures
Follow these steps to upload a bundle:
Navigate to the PageBuilder Editor > Developer Tools > Deployer. The Deployer page displays all running bundles and bundles uploaded in the previous 90 days.
Click Upload Bundle to open the Upload Bundle window.
Enter a descriptive Bundle Name that clearly distinguishes your bundle from others.
Click
Upload Bundle to select the .zipfile from your system's file browser.Click Upload Bundle.
Your bundle now appears on the main Deployer page, ready for deployment.
Deploying your bundle allows you to preview how your feature and components behave in different environments, but does not make the changes available in your website. Follow these steps to deploy a bundle:
Navigate to the PageBuilder Editor > Developer Tools > Deployer. The Deployer page displays all running bundles and bundles uploaded in the previous 90 days.
Click
next to your desired bundle > Deploy to open the Deploy Bundle window.Select the PageBuilder Engine version you want to use to deploy your bundle from the drop-down list.
Click Deploy.
Your deployed bundle is available in the Running section of the Bundles page.
Note
If your build remains stuck for more than five minutes, you get an ETIMEDOUT error message. Click the download icon 
to download the build logs, and click ok. Test your bundle again before attempting another deployment.
Preview how your bundle renders before promoting it by following these steps:
Navigate to the PageBuilder Editor > Developer Tools > Deployer. The Deployer page displays all running bundles and bundles uploaded in the previous 90 days.
Click
next to your desired bundle > Preview. This opens your bundle in a new window.After reviewing your code changes, click Back to deployer in the top right corner to return to the Deployer page.
Deploying your bundle does not make it live or available to your end users; you must promote your bundle to do so. Follow these steps to promote your bundle to live status:
Navigate to the PageBuilder Editor > Developer Tools > Deployer. The Deployer page displays all running bundles and bundles uploaded in the previous 90 days.
Click
next to your desired bundle > Promote to open the Promote Deployment window.Click Promote.
A green Live indicator appears next to your running bundle, confirming it's now active on your site.
If your bundle gets stuck during deployment, terminate it by following these steps:
Navigate to the PageBuilder Editor > Developer Tools > Deployer. The Deployer page displays all running bundles and bundles uploaded in the previous 90 days.
Click
next to your desired bundle > Terminate to open the Terminate Deployment window.Click Terminate to confirm.