The Extensions documentation is no longer updated. Read the new Canva API docs here.

Published URL

Share an external link for users to view their published assets.

When a publish extension uploads a user's design to the destination platform, the /publish/resources/upload endpoint can provide a url:

{
"type": "SUCCESS",
"url": "https://example.com"
}
JSON

This URL is shown in the dialog that appears after the design is published.

For an app to be approved for release via the Apps Directory(opens in a new tab or window), it must provide a URL that satisfies the UX guidelines.

You can configure a publish extension to display the URL of the published design with the anchor text "View in [App name]" instead of the complete URL.

To do this:

  1. Navigate to an app via the Developer Portal.
  2. From the Extensions page, expand the Publish pane.
  3. Enable Generate external link.

UX guidelines

At a minimum, the URL must allow the user to view their published design in the context of the destination platform. For example, if a user publishes a design to Twitter, they should see a link to their tweet.

If the destination platform expects further action, the URL should take the user to where they can complete that action. For example, a website creation tool may provide the URL of a page that allows the user to choose where to place their published design.

The URL must be fewer than 2000 characters.