<!-- Generated from /badge at build time. Do not edit by hand. -->
<!-- Source of truth: the rendered page. A hand edit here is overwritten on the next build. -->

# Designesy — /badge

Canonical page: https://www.designesy.org/badge

---

## Scored by Designesy

Embed your site's live score: the grade, the score and the date it was measured, linked to the full report.

An automated score from 45 deterministic checks against the [published contract](/contracts/design-system), on the date shown. It does not certify the site, attest to legal or accessibility compliance, or endorse the site or its products.

## Live badge

One image per site, at `/api/badge?url=`. It shows the site, its grade and score, and the date of the run, and links to the site's report. A site that cannot be read shows "Not scored".

The badge on ink, for light pages. The default.

### HTML

```
<a href="https://www.designesy.org/score?url=designesy.org" target="_blank" rel="noopener"> <img src="https://www.designesy.org/api/badge?url=designesy.org" alt="Scored by Designesy: live score for designesy.org" height="44" /> </a>
```

### Markdown

```
[![Scored by Designesy: live score for designesy.org](https://www.designesy.org/api/badge?url=designesy.org)](https://www.designesy.org/score?url=designesy.org)
```

## How it works

1. **The badge reads the score cache.** It shows the score the cache holds for your site and the date that score was measured: the same run your [/score](/score) report shows.
2. **A site with no score in the cache is scored once**, by the same 45 checks the score page runs, and later views read that result. New scores started by badges are rate limited; at the limit the badge reads "Not scored" for a minute, then tries again.
3. **The badge names the site it scored**, and its link opens that site's report.
4. **When the site cannot be read** (blocked, unreachable, or an address the engine refuses), the badge reads "Not scored" and shows no grade.

## Grade scale

The score is out of 100: a weighted average of the 45 checks, adjusted by an anti-slop deduction, an originality lift and two caps. The [methodology](/methodology) shows the arithmetic, and the [contract](/contracts/design-system) lists every check.

## Static images

Three fixed images read "Scored by Designesy" and carry no grade, for places that cannot load a per-site image. Use one only on a site Designesy has scored, linked to that site's score: replace `YOURSITE.com` with your domain.

Dark

For light-background sites (most common).

156 × 32px

Light

For dark-background sites.

156 × 32px

Compact

Mark only, for footers, sidebars, and tight spaces.

28 × 28px

### Dark

```
<a href="https://www.designesy.org/score?url=YOURSITE.com" target="_blank" rel="noopener"> <img src="https://www.designesy.org/badge.svg" alt="Scored by Designesy" width="156" height="32" /> </a>
```

### Light

```
<a href="https://www.designesy.org/score?url=YOURSITE.com" target="_blank" rel="noopener"> <img src="https://www.designesy.org/badge-light.svg" alt="Scored by Designesy" width="156" height="32" /> </a>
```

### Compact

```
<a href="https://www.designesy.org/score?url=YOURSITE.com" target="_blank" rel="noopener"> <img src="https://www.designesy.org/badge-compact.svg" alt="Scored by Designesy" width="28" height="28" /> </a>
```
