ZEKTOR.IO Docs

Badges

Embed a "Hosted on ZEKTOR.IO" badge on your site, docs or README — one line of HTML or Markdown, no script and no cookies.

Overview

If you want to tell your visitors where your data is hosted, we serve a set of ready-made badges from zektor.io/badge.svg. They are free to use for anyone running on Zektor.io — no account link, no permission request.

Pick one, copy the snippet, paste it into your footer:

Tip: The badge picker has a live preview of every size and theme with copy-ready HTML, Markdown and image URLs. This page documents the underlying endpoint.

Quick start

<a href="https://zektor.io?utm_source=badge" target="_blank" rel="noopener">
  <img src="https://zektor.io/badge.svg?variant=default&amp;theme=auto"
       alt="Hosted on ZEKTOR.IO"
       width="142" height="46" loading="lazy">
</a>

For a README:

[![Hosted on ZEKTOR.IO](https://zektor.io/badge.svg?variant=default&theme=auto)](https://zektor.io)

The endpoint

GET https://zektor.io/badge.svg?variant=<variant>&theme=<theme>

No authentication. Unknown or misspelled parameters fall back to the defaults rather than returning an error, so a typo leaves a badge in the wrong style — never a broken image in your footer.

variant

ValueSizeUse for
compact116 × 32Dense footers, link rows
default142 × 46The default. Most footers.
banner332 × 58Footer bars, about pages. Includes the Made-in-Germany mark.

theme

ValueBehaviour
autoThe default. Light or dark per the visitor's prefers-color-scheme.
lightAlways light. For light page backgrounds.
darkAlways dark. For dark page backgrounds.

auto resolves inside the visitor's browser, not on our server, so one cached image serves both. Browsers without prefers-color-scheme support get the light badge.

Notes

  • Set width and height. The SVG carries its own size, but declaring both on the <img> reserves the space before the image arrives, so your footer does not shift as it loads. The table above lists them.
  • It is a plain image. No script, no cookie, nothing running on your visitors' browsers. About 5 KB — the logo travels inside the SVG, because an SVG inside an <img> is not allowed to fetch anything of its own. Served with a one-hour browser cache and a one-day shared cache, so a change to the artwork reaches existing embeds within a day.
  • Self-hosting. The endpoint sends Access-Control-Allow-Origin: *, so you can fetch and inline the SVG in a build step if you would rather not make a third-party request. You then have to update it yourself when the artwork changes.
  • Email and older CMSes. Some environments strip SVG. If you need a PNG, ask us.

Using the mark

  • Anyone with an account may use the badge to say their service runs on Zektor.io.
  • Link it back to zektor.io. The snippets above already do.
  • Do not alter the artwork — no recolouring, stretching, or rebuilding the mark. Use the hosted URL and it stays correct.
  • Do not imply that Zektor.io endorses, partners with, or certifies your product. The badge states where you host, nothing more.

Need a different size, a transparent background, or the logo on its own? Email us.

On this page