Light Mode

Request light-friendly logos with ?variant=light and handle fallbacks cleanly.

Light mode

Use variant=light to request a logo that works on light backgrounds.

Quick take: add ?variant=light to get a light-compatible logo, and keep fallback=true for safe defaults.

Use light to request the light variant.

Not every domain has a light variant. Use fallback=false if you want a hard 404 when missing.

curl "https://api.brandql.com/logo/stripe.com?variant=light"

How it works

We look for light-friendly assets across multiple sources (favicons, Open Graph images, manifest icons). If a light variant exists, you’ll get it. If it doesn’t, we return the default logo unless you opt out of fallback.

Strict mode

If you only want a result when a light variant actually exists, set fallback=false. If no light variant is available, the response is a 404.

See Fallback Parameter.

Light mode in HTML

Use a picture element to serve the light logo only when the user has light mode enabled:

<picture>
  <source
    media="(prefers-color-scheme: light)"
    srcset="https://api.brandql.com/logo/stripe.com?variant=light"
  />
  <img
    src="https://api.brandql.com/logo/stripe.com"
    alt="Stripe"
  />
</picture>

Notes

Not every domain has a light variant.
If you prefer a transparent background, use variant=transparent instead. See Variant Parameter.

Was this page helpful?