{
  "name": "BotPages.net partner badge",
  "updated": "2026-11-16",
  "purpose": "Placing this badge on a listed page is what turns the link from BotPages.net to that page into a dofollow link. Any followed anchor to botpages.net qualifies; the image is optional.",
  "variants": [
    {
      "id": "default",
      "src": "https://botpages.net/badge.svg",
      "width": 74,
      "height": 20,
      "ratio": "74:20",
      "use": "Light backgrounds. The default.",
      "html": "<a href=\"https://botpages.net/\" target=\"_blank\" rel=\"noopener\"><img src=\"https://botpages.net/badge.svg\" alt=\"BotPages\" width=\"74\" height=\"20\"></a>"
    },
    {
      "id": "dark",
      "src": "https://botpages.net/badge-dark.svg",
      "width": 74,
      "height": 20,
      "ratio": "74:20",
      "use": "Dark backgrounds. The default badge disappears on dark footers.",
      "html": "<a href=\"https://botpages.net/\" target=\"_blank\" rel=\"noopener\"><img src=\"https://botpages.net/badge-dark.svg\" alt=\"BotPages\" width=\"74\" height=\"20\"></a>"
    },
    {
      "id": "mark",
      "src": "https://botpages.net/mark.svg",
      "width": 20,
      "height": 20,
      "ratio": "1:1",
      "use": "Icon only. For a footer row that is already crowded.",
      "html": "<a href=\"https://botpages.net/\" target=\"_blank\" rel=\"noopener\"><img src=\"https://botpages.net/mark.svg\" alt=\"BotPages\" width=\"20\" height=\"20\"></a>"
    },
    {
      "id": "text",
      "width": null,
      "height": null,
      "use": "When images are blocked by CSP or the column is plain text.",
      "html": "<a href=\"https://botpages.net/\">Partner of BotPages.net</a>"
    }
  ],
  "sizing": {
    "control": "width and height attributes on the img, or CSS height with width:auto",
    "keep_ratio": "74:20 (3.7:1)",
    "min_height_px": 16,
    "max_height_px": 24,
    "note": "SVG scales losslessly. Never set width without height: the browser will guess and the proportion breaks."
  },
  "placement": {
    "preferred": "secondary row of the footer, on the same line as the copyright",
    "alignment": "right when the copyright is left-aligned; centre-align the row with display:flex; align-items:center; gap:12px",
    "spacing": "at least 12px from the nearest link, same inset as the copyright",
    "avoid": [
      "header",
      "hero",
      "primary navigation",
      "next to a call-to-action button"
    ],
    "css_notes": [
      "img { display: block } to remove the inline baseline gap",
      "vertical-align: middle if the row cannot be flex"
    ]
  },
  "blocked_image": {
    "symptom": "the anchor works but the image is missing or broken",
    "usual_cause": "Content-Security-Policy img-src does not include botpages.net",
    "fixes": [
      "add https://botpages.net to the img-src directive",
      "drop the image and use the text variant: the dofollow qualification is unchanged"
    ],
    "do_not": [
      "proxy the image through another server",
      "inline a local copy that can go stale"
    ]
  },
  "verification": {
    "endpoint": "https://botpages.net/api/verify-badge",
    "method": "POST",
    "body": {
      "url": "https://example.com"
    },
    "returns": {
      "ok": true,
      "has_badge": true,
      "dofollow": true,
      "listing_id": 42
    }
  },
  "docs": "https://botpages.net/badge/placement"
}