Getting Started | Documentation

Getting Started with StaticDelivr

StaticDelivr is a free, open-source CDN designed for delivering static assets globally. With 570+ points of presence worldwide, your files are served from the edge location closest to your users.

Quick Start

npm Packages

Serve any npm package instantly:

https://cdn.staticdelivr.com/npm/package@version/file

Example:

<script src="https://cdn.staticdelivr.com/npm/react@18.2.0/umd/react.production.min.js"></script>

GitHub Files

Serve files directly from any public GitHub repository:

https://cdn.staticdelivr.com/gh/user/repo/branch/file

Example:

<script src="https://cdn.staticdelivr.com/gh/jquery/jquery/main/dist/jquery.min.js"></script>

WordPress Assets

Serve WordPress themes, plugins, and core files:

Themes:

<link rel="stylesheet" href="https://cdn.staticdelivr.com/wp/themes/theme-name/version/style.css">

Plugins:

<script src="https://cdn.staticdelivr.com/wp/plugins/plugin-name/tags/version/file.js"></script>

Google Fonts

Load Google Fonts through our CDN:

<link href="https://cdn.staticdelivr.com/gfonts/css2?family=Open+Sans" rel="stylesheet">

Image Optimization

Optimize any image on-the-fly with our image API:

<img src="https://cdn.staticdelivr.com/img/images?url=https://example.com/photo.jpg&w=800&q=80&format=webp" alt="Optimized image">

url – Original image URL (must be publicly accessible)
w / h – Optional width/height in pixels (max 4000)
q – Optional quality (1–100), defaults to 80
format – Optional output format (webp, avif, jpeg, png)

URL Structure Reference

Source	URL Pattern
npm	`/npm/package@version/file`
GitHub	`/gh/user/repo/branch/file`
WordPress Themes	`/wp/themes/name/version/file`
WordPress Plugins	`/wp/plugins/name/tags/version/file`
WordPress Core	`/wp/core/trunk/file`
Google Fonts	`/gfonts/css2?family=FontName`
Images	`/img/images?url=SOURCE_URL`

Version Syntax

For npm packages, you can use semantic versioning:

Exact version: @1.2.3
Latest minor: @1.2 (gets latest patch)
Latest major: @1 (gets latest minor/patch)
Latest: @latest or omit version

Best Practices

Always specify versions in production - This ensures your site won't break if a package updates.
Use minified files - Most packages include .min.js or .min.css versions for smaller file sizes.
Combine with your build process - For complex applications, use StaticDelivr for third-party libraries while bundling your own code.
Use official integrations - Let our WordPress plugin and StaticDelivrImage React component handle URL rewriting and image optimization where possible.

What's Next?

Supported Use Cases - See all the ways you can use StaticDelivr
Caching & Performance - Understand how caching works
API & Tools - Explore advanced features
WordPress Integration Guide - Install the free WordPress plugin
Frontend Usage Guide - Use the React/Next.js image component