The Great Django Webring

Discover and connect Django community sites — one hop at a time.

What is a Webring? #

A webring is a set of sites linked in a circle. Each site links to the previous and next, helping visitors discover related content and foster community connections.

This ring highlights Django-related blogs, projects, and resources.

Member Sites #

Add the Webring to Your Site #

Paste the snippet below where you want the widget to appear:

<webring-css site="https://your-website-url.com"></webring-css>
<script src="https://djangowebring.com/static/webring.js"></script>

Replace https://your-website-url.com with your website URL as listed in the webring.

Color schemes #

Set the optional color-scheme attribute to match your site: light (the default), dark, or auto, which follows the visitor's light or dark system setting. Missing or unknown values use light, so the snippet above keeps working unchanged.

Light #

A light banner for sites with a light background (the default).

<webring-css site="https://your-website-url.com" color-scheme="light"></webring-css>

Dark #

A dark banner for sites with a dark background.

<webring-css site="https://your-website-url.com" color-scheme="dark"></webring-css>

Auto #

Follows the visitor's light or dark system setting.

<webring-css site="https://your-website-url.com" color-scheme="auto"></webring-css>

Themes #

Set the optional theme attribute to change the banner's look. It combines with color-scheme: every theme has a light and a dark version.

Default #

theme="default"

Today's banner. It's used when theme is missing or unknown, and it may evolve.

<webring-css site="https://your-website-url.com" theme="default" color-scheme="auto"></webring-css>

Light

Dark

Og #

theme="og"

The original banner, frozen, for sites that want to keep it exactly as it is.

<webring-css site="https://your-website-url.com" theme="og" color-scheme="auto"></webring-css>

Light

Dark

Django #

theme="django"

Flat and green, in the spirit of djangoproject.com.

<webring-css site="https://your-website-url.com" theme="django" color-scheme="auto"></webring-css>

Light

Dark

Dracula #

theme="dracula"

The Dracula palette, with Alucard as its light variant.

<webring-css site="https://your-website-url.com" theme="dracula" color-scheme="auto"></webring-css>

Light

Dark

Pony #

theme="pony"

Pink and magenta, inspired by djangopony.com.

<webring-css site="https://your-website-url.com" theme="pony" color-scheme="auto"></webring-css>

Light

Dark

Djangonaut #

theme="djangonaut"

Deep purple, in the spirit of djangonaut.space.

<webring-css site="https://your-website-url.com" theme="djangonaut" color-scheme="auto"></webring-css>

Light

Dark

Custom #

theme="custom"

A neutral starter. Copy it to build your own theme.

<webring-css site="https://your-website-url.com" theme="custom" color-scheme="auto"></webring-css>

Light

Dark

Make your own #

Every color, border and font is a --webring-* CSS custom property, and your page's CSS can override any of them. Start from the custom theme and change what you like:

<style>
  webring-css {
    --webring-bg: #FFFBEA;
    --webring-border: #8A4B08;
    --webring-border-accent: #F0B429;
    --webring-accent: #8A4B08;
    --webring-button-bg: #F0B429;
    --webring-button-border: #F0B429;
    --webring-button-text: #3E2003;
  }
</style>
<webring-css site="https://your-website-url.com" theme="custom"></webring-css>

The custom theme in webring.js lists every property and what it controls. To share your theme with everyone, copy it, give it a name and open a pull request.

Layouts #

The optional layout attribute changes the banner's shape. It combines with theme and color-scheme, and it is ignored by theme="none". Missing or unknown values use auto.

Auto #

layout="auto"

The default. Three columns with unicorns, switching to a single column when the banner is narrower than 480px. You don't need to set it.

<webring-css site="https://your-website-url.com" layout="auto"></webring-css>

Wide #

layout="wide"

Always three columns with unicorns.

<webring-css site="https://your-website-url.com" layout="wide"></webring-css>

Compact #

layout="compact"

Always one column with no unicorns and tighter spacing. Good for sidebars and footers.

<webring-css site="https://your-website-url.com" layout="compact"></webring-css>

Responsive #

layout="responsive"

Like auto, but sized with a CSS container query. It fills its container and adapts to it, so use it where the wrapper has a definite width. In a shrink-to-fit wrapper it can't size itself from its content, so it never gets narrower than 280px.

<webring-css site="https://your-website-url.com" layout="responsive"></webring-css>

Unstyled #

Want the banner to look like the rest of your site? Set theme="none" and the widget renders plain semantic HTML into your page, with no shadow DOM and no styles, so your own CSS applies. color-scheme is ignored. Keep both the element and the script tag so the daily check still finds them.

<webring-css site="https://your-website-url.com" theme="none"></webring-css>
<script src="https://djangowebring.com/static/webring.js"></script>

It renders a <nav> with a sentence and a list of Prev, Random and Next links, which you can style with selectors like webring-css nav a:

<nav aria-label="Django Webring">
  <p><a href="https://your-website-url.com">Your Site</a> is part of The Great Django Webring</p>
  <ul>
    <li><a href="..." title="Previous site">Prev</a></li>
    <li><a href="..." title="Random site">Random</a></li>
    <li><a href="..." title="Next site">Next</a></li>
  </ul>
</nav>

Live Demo #

Join the Webring #

Have a Django-related site to share? We’d love to add it.