Parameters

NameTypeOptionalDefault
🔑  tokenstringfalsen/a
↔️ sizeintegertrue128
🖼️ formatstringtruejpg
💡 themestringtrueauto
⚫️ greyscalebooleantruefalse
⛓️‍💥 fallbackstringtruemonogram

Standard

<img src="https://img.logo.dev/shopify.com" alt="Shopify logo" />
Logos returned without any parameters will be 1:1 aspect ratio, 128px tall and wide, and jpg formatted.
Shopify logo

https://img.logo.dev/shopify.com


Rate-limiting

In order to avoid the limits, you’ll need an API key or to upgrade your account. Learn more about our rate limiting policies.

Need an API key? Sign up for a free account

By signing up for a free account you’ll have enough requests to manage most projects.
Your API token is required when using the endpoint publicly.
<img src="https://img.logo.dev/shopify.com?token=YOUR-KEY-HERE" alt="Shopify logo" />

PNG instead of JPG

<img src="https://img.logo.dev/shopify.com?format=png" alt="Shopify logo in PNG format" />
In some cases, PNGs with limited color palettes will result in smaller image files with less compression. Using PNGs allows for transparency, although not all logo images will be compatible.
Shopify logo in PNG format

https://img.logo.dev/shopify.com?format=png


Desaturated

<img src="https://img.logo.dev/shopify.com?greyscale=true&format=png" alt="Shopify logo in greyscale" />
Desaturated logos are most useful for landing pages when you want to normalize colors across the set.
Shopify logo in greyscale

https://img.logo.dev/shopify.com?greyscale=true


Light and dark modes

<img src="https://img.logo.dev/apple.com?theme=dark&format=png" alt="Apple logo for dark backgrounds" />
The theme parameter adjusts logo colors for visibility on your background.
  • theme=dark: Use when displaying logos on dark backgrounds. Inverts light-colored logos (e.g., white logos become black).
  • theme=light: Use when displaying logos on light backgrounds. Inverts dark-colored logos (e.g., black logos become white).
This feature requires images with transparency.
Apple logo for dark backgrounds

https://img.logo.dev/apple.com?theme=dark&format=png

Apple logo for light backgrounds

https://img.logo.dev/apple.com?theme=light&format=png


Resizing images

<img src="https://img.logo.dev/shopify.com?size=80" alt="Shopify logo resized to 80px" />
Our image CDN will resize to any valid integer, but we recommend staying under 600px when using raster images like jpg and png.
Shopify logo resized to 80px

https://img.logo.dev/shopify.com?size=80


Retina images

<img
  src="https://img.logo.dev/shopify.com?size=80&retina=true"
  alt="Shopify logo optimized for retina displays"
  width="80"
  height="80"
/>
The retina=true parameter doubles the source image resolution (160px) while displaying at the specified size (80px), creating sharp images on high-density displays. Without this parameter, logos may appear blurry.

Fallback images

In the case where no image is found for a given domain, the API will return a black and white monogram of the first letter of the domain with HTTP Status Code 200 OK.
Example fallback monogram

https://img.logo.dev/example.com

If you want to suppress these monograms use the parameter fallback=404 to recieve an empty response and HTTP Status Code 404 Not Found.