Replace custom font file | Webflow Developer Documentation

curl -X PUT https://api.webflow.com/v2/sites/580e63e98c9a982ac9b8b741/custom_fonts/66f3a1b2c4d5e6f7a8b9c0d1/file \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "fileName": "AcmeSans-Regular-v2.woff2",
  "fileHash": "3c7d87c9575702bc3b1e991f4d3c638e"
}'

{
  "customFont": {
    "id": "66f3a1b2c4d5e6f7a8b9c0d1",
    "fontFamily": "Acme Sans",
    "format": "woff2",
    "fileName": "AcmeSans-Regular.woff2",
    "weight": 400,
    "italic": false,
    "fontDisplay": "swap",
    "axes": [
      {
        "tag": "wght",
        "min": 100,
        "max": 900,
        "defaultValue": 400,
        "name": "Weight"
      }
    ],
    "hostedUrl": "https://uploads-ssl.webflow.com/6437e21619d24aff35b2e4f2/66f3a1b2-AcmeSans-Regular.woff2"
  },
  "upload": {
    "url": "https://webflow-prod-assets.s3.amazonaws.com/",
    "fields": {
      "bucket": "string",
      "key": "6437e21619d24aff35b2e4f2/fonts/66f3a1b2c4d5e6f7a8b9c0d1-AcmeSans-Regular.woff2",
      "Policy": "string",
      "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
      "X-Amz-Credential": "string",
      "X-Amz-Date": "string",
      "X-Amz-Signature": "string",
      "Content-MD5": "string",
      "acl": "public-read",
      "Cache-Control": "max-age=31536000",
      "Content-Type": "font/woff2",
      "success_action_status": "201",
      "X-Amz-Security-Token": "string"
    },
    "expiresAt": "2026-05-06T12:15:00.000Z"
  }
}

Replace the binary of an existing custom font while preserving its ID and any references to it. The upload handshake is identical to Create custom font.

If the existing font has a non-empty axes array (a variable font), you must include an axes field in the request. Send axes: [] to declare that the new binary is a static font, or send the new variable axes to declare it is still variable. Omitting axes when the existing font is variable returns 400.

Required scope | sites:write

Replace the binary of an existing custom font while preserving its ID and any references to it. The upload handshake is identical to [Create custom font](#operation/create-custom-font). If the existing font has a non-empty `axes` array (a variable font), you must include an `axes` field in the request. Send `axes: []` to declare that the new binary is a static font, or send the new variable axes to declare it is still variable. Omitting `axes` when the existing font is variable returns `400`. Required scope | `sites:write`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

font_idstringRequiredformat: "objectid"

Unique identifier for a custom font on a site

Request

Information about the replacement font binary

fileNamestringRequired

File name including extension. Accepted extensions are .woff2, .woff, .ttf, .otf, and .eot. Maximum 256 characters.

fileHashstringRequired

Lowercase hex MD5 hash of the font binary (exactly 32 characters)

axeslist of objectsOptional

Variable font axes for the replacement binary. Required when the existing font has a non-empty axes array.

Response headers

LocationstringOptional

URL of the custom font resource

Response

File replacement initiated. Upload the binary to the presigned S3 URL in upload to complete the process.

customFontobject

A custom font uploaded to a Webflow site

uploadobject

Presigned S3 upload details. Post the font binary to url as multipart/form-data, including every key from fields plus the binary itself in a field named file. The file field must be the last field in the form.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error