Neocities
Neocities is a file-based static host. Upload your HTML files with the snippet already in them, or edit them directly in the Neocities dashboard editor.
Edit your HTML files in the Neocities dashboard
Log in to Neocities and go to your site's dashboard. Click on any HTML file to open the built-in editor. Find the closing </body> tag and paste the StatelessID snippet just before it. Click Save.
If your site has multiple HTML pages and you want to track all of them, you need to edit each file individually. Neocities does not have a global template system — each HTML file is standalone. This is by design for the retro/personal web ethos Neocities embraces.
A practical shortcut: if all your pages share the same footer HTML, create a footer.html file as a reference document and copy from it whenever you add a new page. It is not automatic inclusion, but it gives you a consistent template to copy from.
Upload edited files via the Neocities editor or API
If you prefer editing locally, download your HTML files, add the snippet in your local editor, then upload the modified files back to Neocities using the file manager (drag and drop in the dashboard). The changes go live immediately when the upload finishes.
Neocities also has a command-line interface (neocities CLI) and an API. If you manage your site through the CLI, add the snippet to your local HTML files and push with neocities push. The CLI syncs changed files to the server.
For sites with many pages, you may want to use a static site generator locally (like Eleventy or plain templating with a build script) that outputs HTML with the snippet already included, then upload the generated files to Neocities. This gives you template reuse without switching hosts.
Neocities domains and site identifiers
Every Neocities site is available at yourusername.neocities.org. Register that URL in your StatelessID dashboard and use its key in your HTML files. Page views from all your Neocities pages will be counted under that one site entry.
Neocities Supporter accounts can set a custom domain. If your site serves at a custom domain, register the custom domain in your StatelessID dashboard and update the snippet key in your HTML files accordingly.
Neocities serves all sites over HTTPS by default. Your site registration should use https://yourusername.neocities.org or https://yourcustomdomain.com as appropriate.
The spirit of Neocities and lightweight tracking
Neocities was built to bring back the personal, handcrafted web. Its community values simplicity, creativity, and independence. StatelessID fits that spirit: one small script tag, no cookies, no surveillance apparatus, just a count of who visited your page.
The Neocities community is generally supportive of tools that respect the open web. You do not need to feel conflicted about adding a lightweight beacon to your personal site. It collects nothing personally identifying — just enough to tell you your pages got some visitors today.
If you want to be transparent with your visitors (which is always a good practice), add a short note in your site's "about" or footer section explaining that the site uses stateless analytics: no cookies, no tracking profiles, just page view counts.
Troubleshooting
I saved the file in the Neocities editor but the dashboard still shows zero page views. Confirm you are looking at the live site URL in your browser (yourusername.neocities.org), not a local file:// preview. The snippet does not fire from local file:// URLs.
I have 20 pages and only some of them have the snippet. Each HTML file on Neocities needs the snippet added individually. Go through each file and confirm the tag is present before </body>. Start with your most-visited pages and work down the list.
The Neocities file editor shows the snippet correctly but the live page does not have it. Try a hard refresh in your browser (Ctrl+Shift+R). Neocities occasionally caches older versions of files in edge nodes. If the hard refresh does not help, save the file again with a small whitespace change to force a cache bust.