On September 25th, 2024, we released v2 of the Apps SDK. To learn what’s new and how to upgrade, see Migration FAQ and Migration guide.

findFonts

API reference for the findFonts method.
This version of the API is in beta. Beta APIs are unstable and may change without warning. You can't release public apps using this API until it's stable.

Lists a curated selection of fonts available for use within Canva when no options is provided, otherwise performs filtering based on the criteria specified in the options.

To list all available fonts, please use the requestFontSelection method.

Parameters

optionsFindFontsOptions
OPTIONAL

Options for retrieving a list of fonts.

Properties of options
fontRefsFontRef[]
OPTIONAL

The refs of the fonts to retrieve.

Returns

The result of retrieving a list of fonts. This is a Promise that resolves with the following object:

fontsFont[]

The retrieved fonts.

Properties of fonts
refFontRef

A unique identifier that points to a font asset in Canva's backend.

namestring

The name of the font.

weightsFontWeight[]

The available font weights for the font.

Properties of weights
weightFontWeightName

The name of the font weight.

The available options include:

  • "normal"
  • "thin"
  • "extralight"
  • "light"
  • "medium"
  • "semibold"
  • "bold"
  • "ultrabold"
  • "heavy"
stylesFontStyle[]

The font styles available for this specific font weight.

The available options include:

  • "normal"
  • "italic"
previewUrlstring
OPTIONAL

The URL of an image that renders a preview of the font.