Getting started
Add this to your HTML <head>:
<link
href="https://fonts.wayscloud.eu/css2?family=Inter:wght@400;700&display=swap"
rel="stylesheet"
/>
Then use the font in your CSS:
body {
font-family: 'Inter', system-ui, sans-serif;
}
That’s it. The browser fetches a small CSS file from WAYSCloud, which
declares @font-face blocks pointing at our cached WOFF2 files.
Multiple families
Repeat the family= parameter — the API does not accept
comma-separated families:
<link
href="https://fonts.wayscloud.eu/css2?family=Inter:wght@400;700&family=Source+Serif+4:wght@400;700&display=swap"
rel="stylesheet"
/>
The order in the URL is preserved as the order of @font-face blocks
in the response.
Italic
Use the ital,wght@ axis — 0,N is upright at weight N, 1,N is
italic:
<link
href="https://fonts.wayscloud.eu/css2?family=Inter:ital,wght@0,400;1,400&display=swap"
rel="stylesheet"
/>
The italic face must exist in the family for that weight. Each family’s catalog page lists which weights and styles are available.
display=
display= accepts the standard CSS font-display values: auto,
block, swap, fallback, optional. It applies to every
@font-face block in the response.
What you get
- WOFF2-only delivery — small transfers, modern compression
- No IP, User-Agent, or Referer logging at our edge
- EU-resident infrastructure — no cross-border data hops
font-displaybaked into every block — your fallback text renders immediately, swap to webfont when loaded- Stable URLs — the CSS URL for an active release stays valid
What fails
If something is wrong with your request, /css2 returns HTTP 400
with a CSS-comment body. The five cases:
- Family not in catalog —
/* WAYSCloud Fonts: family "<name>" not in catalog */. Use the Inspect tool below to see what is in the catalog. - Weight not available — e.g.
/* WAYSCloud Fonts: family "Inter:wght@9999" — weight 9999 not available; available: [400, 700] */. The actual list depends on the family. - Italic not available — e.g.
/* WAYSCloud Fonts: family "Source Serif 4:ital,wght@1,400" — italic at weight 400 not available */. - Reserved parameter —
subset=,v=, andtext=are reserved for future use. Each returns 400 with/* WAYSCloud Fonts: parameter "<name>" reserved for future use */. - Unsupported parameter —
effect=is not supported. Returns 400 with/* WAYSCloud Fonts: parameter "effect" not supported */.
Don’t know which fonts your site uses? Paste a URL into Inspect a site. It detects loaded font families and weights, marks which are on WAYSCloud Fonts, and gives you a ready-to-paste replacement snippet.
Self-hosting (fallback)
If you prefer to host font binaries yourself, each family ships a
generated CSS file at
https://fonts.wayscloud.eu/fonts/<slug>/style.css that declares
@font-face blocks for every face the catalog has for that family.
Combined with the upstream license file at
https://fonts.wayscloud.eu/fonts/<slug>/LICENSE.txt and the WOFF2
files alongside, this is a complete bundle you can copy into your
own static hosting. This path keeps you entirely off WAYSCloud’s
edge — a valid choice if you don’t want a managed delivery path.
The primary integration is /css2. Self-hosting is the fallback.