Request Indexing with a Classic Web Button

You love classic internet buttons. We love classic internet buttons. We love seeing it when people use our button on their page.

![[Pasted image 20260417122154.png]]

Hell yeah. Happy to be in this company. from https://riviael.fr/

As part of our efforts to make it as easy as possible to use OP, we thought, if people are linking to our button anyway, that should be allowed to count as an "scan my page please" request. So now the button's all you need to post to OP.

How it works

The first button is a standard image element. The second one is the magic button, but it's still a standard image element. It just goes to a special endpoint that will serve you the button and trigger an indexing request on the page. When the browser loads the image, the OP server fetches and indexes the page. No fetch calls or form submissions needed.

If there's a problem accessing your page, the badge will show up red.

If you're not registered, it will show up greyed out.

HTML Only

In a normal <img>, just use https://octothorp.es/badge without the file extension and add the url that you want to index to it with the ?uri= parameter

<img src="https://octothorp.es/badge?uri=https://put-your-page-url-here.com">

(If you're using an OP server that's not octothorp.es, you'll have to use their version, but it should be at the same path.)

+ JS

If you're handwriting your site, and you don't want to enter the url by hand, you can load our utility script that will add the current page url to the params.

<script type="module" src="https://octothorp.es/linkfill.js"></script>

Or use the <octo-badge> web component, which will do that automatically.

Once you load this script:

<script type="module" src="https://octothorp.es/components/octo-badge.js"></script>

You can then use

<octo-badge server="https://octothorp.es"></octo-badge>

If you want to override the uri param you can do so with the uri attribute. If you want to specify a harmonizer, you can use as like so:

<octo-badge server="https://octothorp.es" uri="https://example.com/my-page" as="harmonizer-name"></octo-badge>

Previous: About Passive Indexing