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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Update custom font

> Updates custom-font metadata for a Webflow site.

`webflow.updateCustomFont` changes a custom font's family, weight, italic state, or font-display mode.

## Example

```ts automations/webflow-update-custom-font.automation.ts theme={null}
import { automation, onDashboardRun } from "automate.ax"
import { webflow } from "automate.ax/webflow"

export default automation("Update custom font", () => {
  onDashboardRun({ title: "Update custom font" })
  webflow.updateCustomFont({
    siteId: "site-id",
    fontId: "font-id",
    fontDisplay: "swap",
    weight: 500,
  })
})
```

## Inputs

Every input accepts a compatible signal. This action requires the `sites:write` OAuth scope. Provide at least one optional property.

| Field         | Type                                                      | Required | Description                                    |
| ------------- | --------------------------------------------------------- | -------- | ---------------------------------------------- |
| `siteId`      | `string`                                                  | Yes      | Webflow site ID.                               |
| `fontId`      | `string`                                                  | Yes      | Custom-font ID.                                |
| `fontFamily`  | `string`                                                  | No       | CSS family name from 1 through 256 characters. |
| `weight`      | `number`                                                  | No       | Integer CSS weight from 1 through 1,000.       |
| `italic`      | `boolean`                                                 | No       | Whether the font is italic.                    |
| `fontDisplay` | `"auto" \| "block" \| "swap" \| "fallback" \| "optional"` | No       | CSS `font-display` value.                      |

## Output

| Field        | Type                | Description            |
| ------------ | ------------------- | ---------------------- |
| `customFont` | `WebflowCustomFont` | Updated font metadata. |

`customFont` includes `id`, `fontFamily`, `format`, `fileName`, `weight`, `italic`, `fontDisplay`, `axes`, and `hostedUrl`.