Every tool in the Panoply directory with a published score has a badge it can show on its own site, docs or GitHub README. The badge is free, it is drawn live from your page on Panoply, and it updates by itself when your score does.
This page walks through it step by step, then answers the questions vendors ask most.
Add the badge in 4 steps
- Open your tool page. Go to the directory and search for your product, or open
panoply.io/tools/your-tool/. - Scroll to the box called Show this score on your site, under the score breakdown.
- Pick a style and copy its snippet. There are 3: a card, a medal and a strip (examples below).
- Paste the snippet into your site’s HTML, or into your README for the strip. That’s it. You never have to update it by hand.
The 3 styles
Card. For websites: a footer, a pricing page or a row of trust marks. Use card-dark in the address on dark pages.
Medal. Sits next to other award badges.
Strip. For a GitHub README or documentation. Its snippet comes in Markdown.
The examples show ClickHouse. Your snippet already has your own address in it.
Show one part of your score
The score has 6 parts. If you are proudest of one of them, you can show that part alone. Take the badge address from your snippet and add the part’s name at the end:
https://panoply.io/score-badge/your-tool/card/openness/
The part names are:
pricing: pricing honesty, out of 20adoption: adoption evidence, out of 25momentum: release and commit activity, out of 15 (open-source products only)openness: openness and exit, out of 15sentiment: practitioner sentiment from G2 and Gartner Peer Insights, out of 10editorial: our editorial verdict, out of 15
It works with all 3 styles. A full snippet for a single part looks like this:
<a href="https://panoply.io/tools/your-tool/"><img src="https://panoply.io/score-badge/your-tool/card/openness/" alt="Your Tool on Panoply: openness and exit" width="270" height="64"></a>
Show your category rank
If your tool is in the top 10 of its category, add rank the same way:
https://panoply.io/score-badge/your-tool/card/rank/
The badge reads “Top 3”, “Top 5” or “Top 10” with the category name. It exists only for categories with at least 5 scored tools, and only for tools in the top 10.
All badge addresses
https://panoply.io/score-badge/your-tool/card/ overall score, light pages
https://panoply.io/score-badge/your-tool/card-dark/ overall score, dark pages
https://panoply.io/score-badge/your-tool/medal/ overall score, medal
https://panoply.io/score-badge/your-tool/strip/ overall score, README strip
https://panoply.io/score-badge/your-tool/STYLE/PART/ one part: pricing, adoption, momentum, openness, sentiment, editorial
https://panoply.io/score-badge/your-tool/STYLE/rank/ category rank
Questions vendors ask
Does the badge cost anything?
No. It is free for every tool with a published score.
Does showing the badge change my score?
No. Showing it, removing it, sponsoring Panoply or being an affiliate partner changes nothing. The score comes from the evidence listed on your page.
How often does the number change?
Scores are recomputed on the 1st of every month. The badge picks up the new number by itself, within a day. The month on the badge tells readers how fresh it is.
What if my score goes down?
The badge shows the current number, whatever it is. You can switch to a single part or take the badge down at any time.
Can I resize it?
Yes. The badge is a vector image, so it stays sharp at any size. Change the width and height in the snippet and keep the proportions.
Why does the snippet link to Panoply?
So your visitors can check the number. The link goes to your own page on Panoply, where every point is listed with its reason and source.
My tool page has no badge box. Why?
Your tool has no published score yet. We publish a score only when at least 4 of its 6 parts have evidence we can check. Write to us with links to your pricing page, your docs and your G2 or Gartner listing, and we will look at it.
One of the part badges shows nothing. Why?
That part has no evidence for your tool, so it has no badge. The usual case is momentum for a closed-source product: there is no public code to measure.
A fact behind my score is wrong. What do I do?
Send us the page that proves it, for example your pricing page or a docs page. We correct the fact and the score follows at the next run.
Does it work in a GitHub README?
Yes. Use the strip and its Markdown snippet. GitHub loads it like any other README badge.
How is the score calculated?
The full method, with every formula, is on the Panoply Score page.