Fonts

List, upload, rename and delete the fonts a merchant uses on their own store, through the Store API. Admin tokens only.

Fonts are Online Store > Fonts in Store Admin: font families the merchant uploads for their themes and checkout, next to the platform's font library. These endpoints accept Store Admin API tokens and connected AI tools only; app tokens are refused with STORE_API_ADMIN_TOKEN_REQUIRED. Reads require read_storefront; changes require write_storefront.

A font's handle (store:<id>) is a value for a theme's font_picker setting (see Section schema) and for the checkout font, alongside the library's handles. Themes never see font files: the storefront adds the @font-face rules and serves the files from the store's own domains only, so other sites cannot use them.

To add a font, create a font upload with the file's exact size, PUT the file to the returned signed URL, then upload the font with the upload_id. WOFF2, WOFF, TTF and OTF files of up to 2 MB are accepted; each is checked with OTS, the sanitizer Chrome and Firefox use, and stored and served as WOFF2. The family name, weight (a range for variable fonts) and style come from the font itself. A store has at most 20 fonts with up to 4 files each; add a face to a font with font_id.

Every upload needs the merchant's confirmation of the licence statement in List fonts: send licence_accepted: true and the statement's version as terms_version only after the merchant has read and confirmed it. Each upload records that acceptance (the statement, the token or connected user, and the file's checksum); deleting a font keeps the record. A font that a theme or the checkout still uses cannot be deleted (FONT_IN_USE, with error.details.used_in).

Endpoints#

List fonts

GET read_storefront Admin tokens only

List the store's own fonts, the limits and the licence statement.

Returns every font family the store uploaded, oldest first, each with its faces (weight, style and stored size in bytes). handle is the value a theme's font_picker setting and the checkout font take (store:<id>); the library fonts keep their own handles. limits are store-wide: at most max_families families, max_faces faces per family and max_file_bytes per uploaded file. licence is the statement the merchant confirms on every upload, in the request language (English by default), with its version. Admin tokens only: Store Admin API tokens and connected AI tools can call this endpoint; app tokens are refused with STORE_API_ADMIN_TOKEN_REQUIRED.

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

401 UNAUTHORIZED
Authorization header missing, malformed, or token invalid/expired.
402 SUBSCRIPTION_REQUIRED
The store does not have an active or trialing subscription.
403 STORE_API_SCOPE_REQUIRED
Token is valid but lacks the required scope for this call.
429 RATE_LIMITED
The token's request allowance is exhausted. Retry after the Retry-After header.

curl 'https://api-store.tringify.com/api/2025-01/fonts' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/fonts", {
  method: "GET",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/fonts",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{"success":true,"data":{"fonts":[{"id":"3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63","handle":"store:3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63","family_name":"Brand Sans","display_name":"Brand Sans","faces":[{"weight":"100 900","style":"normal","bytes":48400},{"weight":"400","style":"italic","bytes":31220}],"created_at":"2026-10-30T09:12:44Z"}],"limits":{"max_families":20,"max_faces":4,"max_file_bytes":2097152},"licence":{"version":"2026-10-30","text":"I confirm that I own this font or hold a licence that allows me to use it on my website, and that I am responsible for that licence. Tringify hosts the file only for this store and does not license fonts.","confirm":"I confirm the statement above"}}}

Create a font upload

POST write_storefront Admin tokens only

Get a signed URL to upload one font file to.

Upload the file's bytes with HTTPS PUT to the returned url within expires_in seconds, sending every returned header unchanged (the headers are signed; do not send the Store API bearer token there). size_bytes must be the file's exact size, at most 2 MB. Then call Upload a font with the returned upload_id. An upload that is never turned into a font is discarded. Admin tokens only: Store Admin API tokens and connected AI tools can call this endpoint; app tokens are refused with STORE_API_ADMIN_TOKEN_REQUIRED.

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`size_bytes` required	`integer`	The font file's exact size in bytes. Example: `48432`

Errors

401 UNAUTHORIZED
Authorization header missing, malformed, or token invalid/expired.
402 SUBSCRIPTION_REQUIRED
The store does not have an active or trialing subscription.
403 STORE_API_SCOPE_REQUIRED
Token is valid but lacks the required scope for this call.
429 RATE_LIMITED
The token's request allowance is exhausted. Retry after the Retry-After header.
400 STORE_API_INVALID_REQUEST_BODY
The request body is not valid JSON or size_bytes is missing.
413 FONT_FILE_TOO_LARGE
size_bytes is above max_file_bytes.
400 STORE_API_BODY_PROPERTY_UNKNOWN
The body has a property this request does not accept. The message and error.details.properties list the allowed and required properties (nested for each object or list of objects).
400 STORE_API_BODY_PROPERTY_INVALID
A body property has the wrong type (error.details.expected_type). The message and error.details.properties list the allowed and required properties.

curl -X POST 'https://api-store.tringify.com/api/2025-01/fonts/uploads' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "size_bytes": 48432
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/fonts/uploads", {
  method: "POST",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN","Content-Type":"application/json"},
  body: JSON.stringify({
    "size_bytes": 48432
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/fonts/uploads",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
    json={
        "size_bytes": 48432,
    },
)
data = res.json()

Response

201

Sample response

{"success":true,"data":{"upload_id":"b2d7e4f1-8a3c-4e69-a051-7c9f2e6d1a84","url":"https://uploads.example.com/signed-put","method":"PUT","headers":{"Content-Type":"application/octet-stream","Content-Length":"48432"},"expires_in":900}}

Upload a font

POST write_storefront Admin tokens only

Turn an uploaded file into a store font, or add a face to one.

Accepts WOFF2, WOFF, TTF and OTF files; the file's own bytes decide the format, not its name. The file is checked with OTS, the sanitizer Chrome and Firefox use, and refused with FONT_FILE_INVALID when it fails; a font whose licence bits forbid embedding is refused with FONT_LICENCE_RESTRICTED. Weight, style and the family name are read from the font itself (a variable font's weight axis gives a range such as 100 900). It is stored and served as WOFF2, only from the store's own domains. Without font_id a new family is created (FONT_LIMIT_REACHED past max_families); with it the face joins that family (FONT_LIMIT_REACHED past max_faces, FONT_FACE_EXISTS when the family already has that weight and style). The merchant must have read and confirmed the licence statement from List fonts: send licence_accepted: true and its version as terms_version, else FONT_LICENCE_NOT_ACCEPTED. Ask the merchant first; never accept it on their behalf. Every upload records the acceptance with the token, the statement and the file's checksum. Admin tokens only: Store Admin API tokens and connected AI tools can call this endpoint; app tokens are refused with STORE_API_ADMIN_TOKEN_REQUIRED.

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`upload_id` required	`string`	`upload_id` from Create a font upload, after the file was uploaded to its URL. Example: `b2d7e4f1-8a3c-4e69-a051-7c9f2e6d1a84`
`licence_accepted` required	`boolean`	`true` once the merchant confirmed the licence statement from List fonts. Example: `true`
`terms_version` required	`string`	The licence statement's `version` the merchant confirmed. Example: `2026-10-30`
`font_id`	`string`	Add the file as another face of this font instead of creating a new font. Example: `3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63`
`display_name`	`string`	Name shown in pickers, up to 80 characters. Default: the font's own family name. Ignored with `font_id`. Example: `Brand Sans`

Errors

401 UNAUTHORIZED
Authorization header missing, malformed, or token invalid/expired.
402 SUBSCRIPTION_REQUIRED
The store does not have an active or trialing subscription.
403 STORE_API_SCOPE_REQUIRED
Token is valid but lacks the required scope for this call.
429 RATE_LIMITED
The token's request allowance is exhausted. Retry after the Retry-After header.
403 STORE_API_ADMIN_TOKEN_REQUIRED
App tokens cannot upload fonts.
400 STORE_API_INVALID_REQUEST_BODY
The request body is not valid JSON or a required field is missing.
404 NOT_FOUND
upload_id names no uploaded file, or font_id no font of this store.
413 FONT_FILE_TOO_LARGE
The uploaded file is above max_file_bytes.
422 FONT_FILE_INVALID
The file is not a WOFF2, WOFF, TTF or OTF font, or the font sanitizer refused it.
422 FONT_LICENCE_RESTRICTED
The font's licence bits forbid embedding it in a website.
422 FONT_LICENCE_NOT_ACCEPTED
licence_accepted is not true or terms_version is not the current statement's version.
422 FONT_LIMIT_REACHED
The store already has max_families fonts, or the font max_faces faces.
409 FONT_FACE_EXISTS
The font already has a face with this weight and style.
400 STORE_API_BODY_PROPERTY_UNKNOWN
The body has a property this request does not accept. The message and error.details.properties list the allowed and required properties (nested for each object or list of objects).
400 STORE_API_BODY_PROPERTY_INVALID
A body property has the wrong type (error.details.expected_type). The message and error.details.properties list the allowed and required properties.

curl -X POST 'https://api-store.tringify.com/api/2025-01/fonts' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "display_name": "Brand Sans",
  "font_id": "3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63",
  "licence_accepted": true,
  "terms_version": "2026-10-30",
  "upload_id": "b2d7e4f1-8a3c-4e69-a051-7c9f2e6d1a84"
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/fonts", {
  method: "POST",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN","Content-Type":"application/json"},
  body: JSON.stringify({
    "display_name": "Brand Sans",
    "font_id": "3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63",
    "licence_accepted": true,
    "terms_version": "2026-10-30",
    "upload_id": "b2d7e4f1-8a3c-4e69-a051-7c9f2e6d1a84"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/fonts",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
    json={
        "display_name": "Brand Sans",
        "font_id": "3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63",
        "licence_accepted": True,
        "terms_version": "2026-10-30",
        "upload_id": "b2d7e4f1-8a3c-4e69-a051-7c9f2e6d1a84",
    },
)
data = res.json()

Response

201

Sample response

{"success":true,"data":{"id":"3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63","handle":"store:3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63","family_name":"Brand Sans","display_name":"Brand Sans","faces":[{"weight":"100 900","style":"normal","bytes":48400},{"weight":"400","style":"italic","bytes":31220}],"created_at":"2026-10-30T09:12:44Z"}}

Rename a font

PATCH write_storefront Admin tokens only

Change the name a font shows in pickers.

Only display_name changes; the family name in the CSS stays the font's own. Pages pick up the new name in theme and checkout pickers right away. Admin tokens only: Store Admin API tokens and connected AI tools can call this endpoint; app tokens are refused with STORE_API_ADMIN_TOKEN_REQUIRED.

Path parameters

Name	Type	Description
`fontId` required	`uuid`	Font id from List fonts. Example: `3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`display_name` required	`string`	Name shown in pickers, 1 to 80 characters. Example: `Brand Sans`

Errors

401 UNAUTHORIZED
Authorization header missing, malformed, or token invalid/expired.
402 SUBSCRIPTION_REQUIRED
The store does not have an active or trialing subscription.
403 STORE_API_SCOPE_REQUIRED
Token is valid but lacks the required scope for this call.
429 RATE_LIMITED
The token's request allowance is exhausted. Retry after the Retry-After header.
403 STORE_API_ADMIN_TOKEN_REQUIRED
App tokens cannot manage fonts.
404 NOT_FOUND
The font does not exist in this store.
400 INVALID_INPUT
display_name is empty or longer than 80 characters.
400 STORE_API_BODY_PROPERTY_UNKNOWN
The body has a property this request does not accept. The message and error.details.properties list the allowed and required properties (nested for each object or list of objects).
400 STORE_API_BODY_PROPERTY_INVALID
A body property has the wrong type (error.details.expected_type). The message and error.details.properties list the allowed and required properties.

curl -X PATCH 'https://api-store.tringify.com/api/2025-01/fonts/3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "display_name": "Brand Sans"
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/fonts/3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63", {
  method: "PATCH",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN","Content-Type":"application/json"},
  body: JSON.stringify({
    "display_name": "Brand Sans"
  }),
});
const data = await res.json();

import requests

res = requests.patch(
    "https://api-store.tringify.com/api/2025-01/fonts/3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
    json={
        "display_name": "Brand Sans",
    },
)
data = res.json()

Response

200

Sample response

{"success":true,"data":{"id":"3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63","handle":"store:3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63","family_name":"Brand Sans","display_name":"Brand Sans","faces":[{"weight":"100 900","style":"normal","bytes":48400},{"weight":"400","style":"italic","bytes":31220}],"created_at":"2026-10-30T09:12:44Z"}}

Delete a font

DELETE write_storefront Admin tokens only

Delete a font and its files.

A font selected in any theme's settings or in a storefront's checkout branding is refused with FONT_IN_USE; error.details.used_in lists where (kind theme with the theme's name, or checkout). Pick another font there first. Deleting removes the font's files; the licence acceptances recorded at upload are kept. Answers HTTP 204 with no body. Admin tokens only: Store Admin API tokens and connected AI tools can call this endpoint; app tokens are refused with STORE_API_ADMIN_TOKEN_REQUIRED.

Path parameters

Name	Type	Description
`fontId` required	`uuid`	Font id from List fonts. Example: `3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

401 UNAUTHORIZED
Authorization header missing, malformed, or token invalid/expired.
402 SUBSCRIPTION_REQUIRED
The store does not have an active or trialing subscription.
403 STORE_API_SCOPE_REQUIRED
Token is valid but lacks the required scope for this call.
429 RATE_LIMITED
The token's request allowance is exhausted. Retry after the Retry-After header.
403 STORE_API_ADMIN_TOKEN_REQUIRED
App tokens cannot manage fonts.
404 NOT_FOUND
The font does not exist in this store.
409 FONT_IN_USE
The font is selected in a theme or the checkout; error.details.used_in lists where.

curl -X DELETE 'https://api-store.tringify.com/api/2025-01/fonts/3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/fonts/3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63", {
  method: "DELETE",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
});
const data = await res.json();

import requests

res = requests.delete(
    "https://api-store.tringify.com/api/2025-01/fonts/3f8c2a91-6d4e-4b7a-9c15-2e7f0a8d5b63",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()