Simple Icons CDN

Colorable and resizable CDN for Simple Icons

API Reference

Base URL Pattern:

GET /:icon_slug/:color?/:dark_mode_color?

Query parameters can be added to customize the icon:

GET /:icon_slug?viewbox=auto&size=24

Usage Examples

1. Basic Usage

Get an icon with its default color and size:

<img src="/coolify" alt="Coolify" />

2. Custom Color

Override the default color with a custom hex color:

<img src="/wordpress/ff0000" alt="WordPress Red" />

3. Dark Mode Support

Provide two colors: one for light mode and one for dark mode. The second color is used when dark mode is active via CSS prefers-color-scheme media query.

<img src="/php/333333/ffffff" alt="PHP" />

4. Custom Size

Set a specific size in pixels using the size parameter:

<img src="/deno?size=64" alt="Deno" />

5. Icon Showcase

Display multiple icons with different customizations:

<div class="icons">
    <img src="/bitcoin?size=48" alt="Bitcoin" />
    <img src="/polkadot?size=48" alt="Polkadot" />
</div>

6. In a Link

Use icons as clickable links to external resources:

<a href="https://coolify.io" target="_blank">
    <img src="/coolify?size=32" alt="Coolify" />
</a>

7. Tech Stack Section

Display your project's technology stack:

<div class="tech-stack">
    <img src="/deno?size=48" alt="Deno" />
    <img src="/php?size=48" alt="PHP" />
    <img src="/wordpress?size=48" alt="WordPress" />
</div>

Parameters

Parameter	Type	Description	Default
`icon_slug`	string	Icon identifier from simpleicons.org	Required
`color`	string	Hex color (e.g., #ff0000) or CSS keyword	Icon's default color
`dark_mode_color`	string	Color for dark mode	Same as color
`viewbox`	string	Set to "auto" for auto-sizing	Square viewBox
`size`	number	Custom size in pixels	Original size

Legal & License Information

📋 CDN Disclaimer

This CDN service is provided as-is without any warranties. By using this service, you agree to the following terms:

No Logging - We do not review, collect, or store any access logs or usage data from this CDN.
No Responsibility - This site is not responsible for how users utilize the icons obtained through this CDN. Users are solely responsible for ensuring their use complies with all applicable laws and brand guidelines.
No Endorsement - The appearance of any brand icon on this CDN does not constitute an endorsement, sponsorship, or affiliation with that brand.
Use at Your Own Risk - This CDN is provided without warranty of any kind, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, and non-infringement.
Availability - We make no guarantees about service availability, uptime, or continuity. The service may be modified or discontinued at any time without notice.

🎨 Simple Icons License & Guidelines

The icons served by this CDN are provided by the Simple Icons project. We comply with the Simple Icons licensing requirements by:

Providing attribution and links to the Simple Icons project
Maintaining a fork of the original simple-icons-cdn repository
Encouraging users to verify individual icon licenses
Directing users to the official Simple Icons disclaimer

Important Icon Licensing Information:

Simple Icons is released under CC0 - however, this does NOT mean all icons within the project are also CC0. Each icon may have different licensing.
Check individual licenses - License data can be found in the icon's entry in the JSON data file or through the license link on the icon's card on the Simple Icons website.
Licenses are subject to change - Regularly check if the license of icons you use have been changed.
Trademark symbols - Icons may include registered trademark (®) or trademark (™) symbols. We follow the Simple Icons Contributing Guidelines to decide inclusion.
Your responsibility - Simple Icons cannot be held responsible for any legal activity raised by a brand. Users must seek correct permissions to use icons relevant to their project.

Brand Guidelines:

Check brand guidelines - Users are encouraged to read brand's branding guidelines and ensure usage is in accordance with them.
Guidelines subject to change - Regularly check if brand guidelines have been updated.
Find guidelines - Brand guidelines can be found in the icon's entry in the JSON data file or through the "Brand Guidelines" link on the icon's card on the Simple Icons website.

Update & Removal Requests:

Brand updates - If you represent a brand and want to update your icon or data, submit an issue to the Simple Icons GitHub repository explaining your affiliation and reasons for the update.
Brand removal - If you represent a brand and want your icon removed, contact removals at simpleicons dot org or submit an issue on GitHub with your affiliation and reasons.

Full Simple Icons Disclaimer: Read the complete legal disclaimer

Related Resources

Simple Icons Website - Browse and search for icons
Simple Icons GitHub - Icon provider repository
Simple Icons Legal Disclaimer - Complete legal information