> ## Documentation Index
> Fetch the complete documentation index at: https://www.canva.dev/docs/apps/llms.txt
> Use this file to discover all available pages before exploring further.

# findFonts

API reference for the findFonts method.

Retrieves a list of fonts.

Only a subset of Canva's fonts are returned.

## Usage

### Get a list of all available fonts

```typescript
import { findFonts } from "@canva/asset";

const response = await findFonts();
```

### Get a specific font

```typescript
import { type FontRef, findFonts } from "@canva/asset";

const placeholderFontRef = "PLACEHOLDER_FONT_REF" as FontRef;

const response = await findFonts({
  fontRefs: [placeholderFontRef]
});
```

### Get multiple specific fonts

```typescript
import { type FontRef, findFonts } from "@canva/asset";

const placeholderFontRef1 = "PLACEHOLDER_FONT_REF" as FontRef;
const placeholderFontRef2 = "PLACEHOLDER_FONT_REF" as FontRef;

const response = await findFonts({
  fontRefs: [placeholderFontRef1, placeholderFontRef2]
});
```

## Parameters

<Prop.List>
  <Prop name="options" type="FindFontsOptions" sourceLineNumbers={[284]}>
    Options for retrieving a list of fonts.

    <PillAccordion defaultExpanded={true} title={<>Properties of <strong>options</strong></>}>
      <Prop.List>
        <Prop name="fontRefs" type="FontRef[]" sourceLineNumbers={[294]}>
          The refs of the fonts to retrieve.
        </Prop>
      </Prop.List>
    </PillAccordion>
  </Prop>
</Prop.List>

## Returns

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

<Prop.List>
  <Prop name="fonts" required type="Font[]" sourceLineNumbers={[305]}>
    The retrieved fonts.

    <PillAccordion defaultExpanded={false} title={<>Properties of <strong>fonts</strong></>}>
      <Prop.List>
        <Prop name="ref" required type="FontRef" sourceLineNumbers={[316]}>
          A unique identifier that points to a font asset in Canva's backend.
        </Prop>

        <Prop name="name" required type="string" sourceLineNumbers={[320]}>
          The name of the font.
        </Prop>

        <Prop name="weights" required type="FontWeight[]" sourceLineNumbers={[324]}>
          The available font weights for the font.

          <PillAccordion defaultExpanded={false} title={<>Properties of <strong>weights</strong></>}>
            <Prop.List>
              <Prop name="weight" required type="FontWeightName" sourceLineNumbers={[384]}>
                The name of the font weight.

                <Prop.Extras>
                  **Available values**:

                  * `"normal"`
                  * `"thin"`
                  * `"extralight"`
                  * `"light"`
                  * `"medium"`
                  * `"semibold"`
                  * `"bold"`
                  * `"ultrabold"`
                  * `"heavy"`
                </Prop.Extras>
              </Prop>

              <Prop name="styles" required type="FontStyle[]" sourceLineNumbers={[388]}>
                The font styles available for this specific font weight.

                <Prop.Extras>
                  **Available values**:

                  * `"normal"`
                  * `"italic"`
                </Prop.Extras>
              </Prop>
            </Prop.List>
          </PillAccordion>
        </Prop>

        <Prop name="previewUrl" type="string" sourceLineNumbers={[328]}>
          The URL of an image that renders a preview of the font.
        </Prop>
      </Prop.List>
    </PillAccordion>
  </Prop>
</Prop.List>