Skip to content
View FactoryRegistry's full-sized avatar

Block or report FactoryRegistry

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
FactoryRegistry/README.md

FactoryRegistry (Factory Registry) — the registry badge

FactoryRegistry is a free, public, regularly updated registry of U.S. manufacturing facilities, compiled from federal records. No login, no paid rankings.

This repository documents the registry badge: a server-rendered SVG that a plant can put on its own website. It states one thing — how complete FactoryRegistry's record of that plant is — and links back to the record so anyone can check it.

SIFCO Forge Group on FactoryRegistry

Get your badge

https://www.factoryregistry.com/badge — find your plant, see your real figure in all six shapes, copy the code. The figure on the badge page is the same figure the badge will show; nothing is sampled or invented.

Embed

<a href="https://www.factoryregistry.com/facility/oh/cleveland/sifco-forge-group-inc-110000386546">
  <img src="https://www.factoryregistry.com/api/badge/110000386546?shape=wide"
       width="446" height="158"
       alt="SIFCO Forge Group on FactoryRegistry" loading="lazy">
</a>

110000386546 is the plant's anchor — the number at the end of its FactoryRegistry URL. The link goes to the plant's page on the registry; the image is the badge. Nothing else is needed: no script, no stylesheet, no account.

Parameters

https://www.factoryregistry.com/api/badge/<anchor>?shape=…&theme=…&scale=…

parameter values default notes
shape wide 446×158 · banner 440×96 · square 300×300 · card 340×210 · portrait 240×310 · strip 330×44 wide wide is the shape the registry itself shows on the company page, so an embedded badge and the registry show the same object. strip is a one-line row without the crest.
theme dark, light dark Use light on a light page. The dark badge on a white page sits in a navy block of its own.
scale 0.53 1 Multiplies the shape's size. Set width/height on the <img> to match. The older `size=compact
v 1 Asks for the verified variant. The registry decides: it is served only where a claim on that plant has been verified; otherwise you get the listed badge. A badge is not a claim you can make about yourself by editing a URL.

Unknown values fall back to the defaults. The URL lives in somebody else's HTML, where a broken image is the failure and a typo is not worth one. A .svg suffix on the anchor is accepted.

What the figure means

Record completeness, never a rating of the company. The percentage says how much of the registry's file on that plant is filled in — it is a statement about the registry's own record, and adding your details raises it. It is never an opinion about the business, and it never shows operating status: the badge is displayed on the company's own website, and a registry's guess about whether they are still trading is not theirs to publish.

figure metal
100 gold
90–99 silver
80–89 bronze
70–79 copper
below 70 tin
no figure yet grey crest; the badge says only that the plant is listed

Most plants have no figure yet: the registry withholds the number where it holds too little to publish one, rather than printing a low score that means "we could not find them".

The badge never affects search ranking, ordering or status on the registry. It reads the record and renders it.

Every badge is checkable

Each plant has a dated attestation page — https://www.factoryregistry.com/attest/<anchor> — a statement of what the registry holds on that plant, on the day you load it, that a buyer can read without taking the badge's word for it. Lines that come from the owner (products, certifications) are marked as the owner's; operating status and source counts are the registry's own, from independent public records.

Shapes

All six on a light page (theme=light) and a dark page (default). Live images.

wide 446×158banner 440×96
wide, light banner, light
square 300×300card 340×210
square, light card, light
portrait 240×310strip 330×44
portrait, light strip, light

The dark set: examples/index.html shows both themes on both backgrounds, ready to copy.

Serving details

  • Served by https://www.factoryregistry.com/api/badge/<anchor> as image/svg+xml, Cache-Control: public, max-age=1800, so a change to the record reaches the badge within half an hour.
  • A badge is about 190 KB (the crest is embedded so the SVG is self-contained); strip is 3 KB. Set loading="lazy" as in the snippet.
  • The endpoint rate-limits abusive clients (HTTP 429 with Retry-After).
  • Privacy: the visitor's browser makes one plain image request to factoryregistry.com, as with any hotlinked image. The badge sets no cookies and runs no code on your page. The registry records the request's Referer as a badge impression, so a plant can see where its badge is shown.

Verified badges

A plant whose claim has been verified can show the verified variant (v=1). Claiming starts on the plant's own page on the registry.

License

Text and example code in this repository: see LICENSE. The badge artwork, the crest and the FactoryRegistry name are marks of FactoryRegistry and are not licensed by this repository; the badge is served by the registry and embedded, not copied.

https://www.factoryregistry.com/

Popular repositories Loading

  1. FactoryRegistry FactoryRegistry Public

    The FactoryRegistry (Factory Registry) badge: embed the record-completeness badge on your plant website

  2. awesome-osint awesome-osint Public

    Forked from jivoi/awesome-osint

    😱 A curated list of amazingly awesome OSINT

  3. OSINT-Framework OSINT-Framework Public

    Forked from lockfale/OSINT-Framework

    OSINT Framework

    JavaScript