Multi-region feature

Learn how to deploy your monday code app to multiple data regions.

monday.com and monday code data centers are located in three different regions: US (United States), EU (Europe), and AU (Australia). Using the multi-region feature, public monday code apps can be deployed to all regions!

Doing so ensures that customer data won't leave its region, helps apps maintain compliance with region-specific regulations (e.g., GDPR), and reduces latency, all while eliminating the need for complex infrastructure setups across multiple jurisdictions.

Eligibility

The multi-region feature is available for public monday code apps. If you have a private app, new deployments will default to the region assigned to your account. You can check which region you are in using these steps:

  1. Open your monday account and click your profile picture in the top-right corner.
  2. Select Administration.
  3. You will see the region listed under General > Profile.

How it works

For developers

App deployment regions will vary based on whether or not the multi-region feature is enabled. The table below explains the behavior for app developers:

Multi-region featureRegion
DisabledThe region the developer's account is in
EnabledUS, EU, AU (after individual deployments)

🚧

Note for early adopters and private app developers

Your app will be hosted on US servers if you deployed it before multi-region support (mid-August 2024). If you want to serve your app from another region, enable multi-region and deploy it to your region of choice.

End users

End users will get the app version that is most relevant based on their region. The table below explains the behavior for end users:

Multi-region featureRegion
DisabledThe region the developer deploys to
EnabledThe region customer's account is in

Use the feature

To use the multi-region feature, you must first enable it and then individually deploy your app to all 3 regions. Once enabled, the feature only impacts new app deployments.

You need to repeat the process for each app if you have more than one. If you don't deploy to each region individually, you won't be able to promote your version to live.

❗️

Once you enable the multi-region feature for an app, you cannot disable it after promoting the app to live.

Step 1: Create or open a draft version

The feature can only be enabled in a draft version, so create a new one or open an existing one!

Step 2: Enable multi-region support

  1. Open the General monday code tab in the Developer Center.
  2. Click Enable multi-region support.
  3. You will now see all three regions listed.

🚧

Having issues enabling the feature?

If you're having issues enabling the multi-region feature, ensure your app:

Step 3: Connect your app to monday code in each region

  1. Install the CLI beta version:
npm install @mondaycom/[email protected]
  1. In the General tab, click Connect to monday code for either Europe or Australia.
  2. Deploy your app using the region flag:
Long flagShort flagDescriptionAccepted values
--region-zThe region to deploy toeu, us, `au
  1. Repeat the process for each region.
mapps code:push -i 1234567 -z au

Step 4: Set your environment variables and secrets

Environment variables and secrets should be configured for each region. Please note that alert policies are configured on the global level.

Existing environment variables and secrets

  1. Click Edit variable or Edit secret.
  2. Enter the value for all three regions.
  3. Click Save.

New environment variables and secrets

  1. Click Add new variable or Add new secret.
  2. Enter the value for all three regions.
  3. Click Save.

Step 5: Publish a new version

Once your app is ready to go, you can promote your draft version to live!

Note: After promoting your app, you cannot disable the multi-region feature.