The Canva Apps SDK, Connect APIs, and MCP are now unified in the Canva Developers SDK. Learn more⁠(opens in a new tab or window).
Canva Developers SDK
The Canva Apps SDK, Connect APIs, and MCP are now unified in the Canva Developers SDK. Learn more⁠(opens in a new tab or window).
Intents
Intents: Asset
Intents: Content
Intents: Design
Intents: Test
Platform: Test

getDesignColors

API reference for the getDesignColors method.

Retrieves the colors currently used in the design.

Usage: Get design colors

import { getDesignColors } from "@canva/design";
const { colors } = await getDesignColors();
TYPESCRIPT

Returns

. This is a Promise that resolves with the following object:

colorsDesignColor[]

The colors used by elements in the current design.

Not all elements are included, and the colors returned may change. The order of colors is not guaranteed.

A solid color from the user's design.

typestring

The only valid value is "solid".

colorstring

The hexadecimal code representing the color.

This is a 6 character code prefixed with a # symbol.

Example

"#ffffff"
TS

Represents a color type that is currently not supported by the SDK.

One entry is returned per unsupported color in the design (no deduplication).

typestring

The only valid value is "unsupported".

Permissions

To use this method, the canva:design:content:read permission must be enabled for the app. To learn more, see Permissions.