Add blinkies and buttons to your website or profile
Published
To add a blinkie or button, you need an image file, an address where the browser can load it and a little HTML, the code used to build a web page. With these three parts, you can arrange the graphics into a personal introduction, a set of links or a compact badge collection.
On this page
Use our original blinkie files and 88x31 button files as practice material. They include editable files or the separate pictures that make up an animation so you can see how the graphics work.
Put the image somewhere you control
On a personal website, upload the image to the service where you keep your page. A folder named images keeps small graphics together. Give the file a simple name, such as small-site.gif or my-button.png.
For a page on Neocities, its official tutorials describe uploading images and editing pages through the dashboard where you manage your files. Keep the image’s folder and filename beside you while you edit the HTML. The browser needs that exact address to find the file.
The address images/small-site.gif looks for an images folder beside the current page. From /about/index.html, it therefore opens /about/images/small-site.gif. A slash at the start, as in /images/small-site.gif, tells the browser to start at the site’s top folder. On another service, use the full web address, such as https://example.org/images/small-site.gif.
Add a blinkie as a statement
Paste this image code where you want the badge to appear:
<img src="images/small-site.gif"
width="150" height="20"
alt="Small site, big ideas">
Match src to your uploaded filename. Set width and height to the image’s intended size. The alt text describes it for people who cannot see it. Use the badge’s words if they carry its message.
blinkies.cafe describes the familiar blinkie format as a 150-by-20 animated badge. Give the badge a little space around it so its edge stays distinct from the surrounding text.
Turn a button into a destination
To make the picture a link, put its code between <a> and </a>:
<a href="https://example.org/">
<img src="images/my-button.png" width="88" height="31"
alt="Visit the Small Things Observatory">
</a>
The two addresses do different jobs. href names the destination; src names the picture. Change both when you adapt somebody’s example for your site.
Make the alternative text describe the link’s purpose. A nearby sentence can explain why you recommend the destination. Our 88x31 guide covers the design and sharing side of the format.
Keep a collection tidy
Put related badges inside this <div> section. The CSS styling code below moves them onto a new line when the screen is narrow:
<div class="badges">
<!-- Add your image or linked-image elements here. -->
</div>
.badges { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; }
.badges img { display: block; }
Group the images by purpose. Personal statements can sit together; links to other sites can form a separate collection with descriptions.
Keep a still version for quieter sections of your page; our blinkie package includes one.
Use a profile editor that accepts HTML
SpaceHey’s About page explains how to change a profile with HTML and CSS. It currently says you need an invitation to open an account. Once you have an account, open the profile editor. Choose a section that accepts HTML and use the full image address, so SpaceHey can load it from your site. Save, then open your public profile and test the image and link.
Follow the platform’s current help pages for account and editor controls. Keep the graphic’s source address in your own notes so you can update it if you move the file. For matching profile colors, use the original SpaceHey themes; they work with this current service.
Fix a missing image or wrong destination
| What you see | What to check |
|---|---|
| Broken-image symbol | Open the address in src; compare the filename, capitals and ending (such as .gif) with the uploaded file. |
| Works on Home but fails on an interior page | Check whether the image address now starts from a different folder; use the examples above. |
| Graphic appears but opens the wrong site | Correct the link’s href; changing src only changes the picture. |
| Badge stretches or blurs | Restore its intended width and height: commonly 150 × 20 for a blinkie or 88 × 31 for a button. |
Keep the creator’s credit and their rules for sharing or changing the image with any graphic you share.