Regions

Canva exists in two regions:

• Global (everywhere except China)
• China

No data is shared between these regions.

This means there are two, completely independent versions of the Developer Portal:

• https://canva.com/developers⁠(opens in a new tab or window)
• https://canva.cn/developers⁠(opens in a new tab or window)

This has a few implications that are relevant to developers.

Apps created via canva.cn must adhere to the following terms and conditions:

• Canva Apps Terms⁠(opens in a new tab or window)
• Canva Developer Terms⁠(opens in a new tab or window)

These terms and conditions are unique to the China region.

The key differences include:

• Your app must adhere to all applicable laws, including:
  • Cybersecurity Law of the People's Republic of China⁠(opens in a new tab or window)
  • Administration of Internet Information Services Procedures⁠(opens in a new tab or window).
• Your app's terms of use must not permit users under the age of 14 to use the app.

If you have any specific questions about these terms, send an email to [email protected]⁠(opens in a new tab or window).

China's data privacy laws require that personal data of Chinese users must be stored on servers within Chinese territories.

Apps created via canva.com are independent of apps created via canva.cn. (The reverse is also true.) If you want to release your app in the Global and China regions, you need to create and maintain the apps in both regions.

The documentation always refers to the canva.com domain. If you're developing an app for China, it's important to replace references to canva.com with canva.cn.

Throughout the lifecycle of an app, Canva may send HTTP requests to your app. The referring domain of these requests depends on the app's region:

• Apps created in the Global region receive requests from the canva.com domain.
• Apps created in the China region receive requests from the canva.cn domain.

Throughout the lifecycle of an app, your app may need to send HTTP requests to Canva. The target domain of these requests depends on the app's region:

• Apps created in the Global region must send requests to the canva.com domain.
• Apps created in the China region must send requests to the canva.cn domain.

At the moment, this is only relevant when an app supports authentication, as apps must redirect users back to Canva at the end of an authentication flow.

When Canva releases a public app in the Global region, it translates the app's copy into a variety of different languages.

In the China region, developers can either:

• Provide copy in English. Canva will translate the copy into Simplified Chinese.
• Provide copy in Simplified Chinese. Canva won't translate the copy.

The end result is that, in the China region, apps are only available in Simplified Chinese.

All HTTP requests that Canva sends to an app have a timeout duration. If the app fails to respond to the request within this duration, the request fails. The exact duration depends on the request.

In the China region, the timeout durations are sometimes longer than the durations in the Global region. This accounts for the slower, less reliable internet speeds in China.