How to Set Up Remarkbox on Your Website

Updated

Remarkbox is a hosted comment system you embed into your pages so the conversation stays with your content. To set it up, you create a namespace through the Setup entry point (no credit card required), then embed the hosted comments on your site. The official site points to a live demo at the bottom of its own page, plus FAQ and Meta sites for more detail. The steps below follow what the site documents; anything it doesn't specify is flagged as a gap rather than filled in with guesswork.

What you need before starting

  • A website where you can edit page templates or insert an embed snippet (the founder's own use case was moving a WordPress blog to a static site, so static sites are explicitly supported).
  • A namespace, which you create through the Setup flow. The site states this is "risk free, no credit card required."
  • A decision on who moderates. The published plan includes one moderator across a few domains.

Setup steps

  1. Go to the Setup entry point. The site's navigation lists "Setup" alongside Demo, Plans, Log in, FAQ, Meta, and About. Start there rather than hunting for a separate signup page.
  2. Create your namespace. This is the identifier that ties your embedded comments to your site. The site treats the namespace as the unit you configure, and the plan covers "a few domains," so you can attach more than one site to it.
  3. Embed the comment system in your pages. Remarkbox is described as a hosted comment service that "embeds in your pages to keep the conversation with your content." You place the embed where you want comments to appear — typically below the article body.
  4. Confirm it renders. The site says you can see Remarkbox in action by scrolling to the bottom of its own page. Use that as your reference for what a working embed looks like before troubleshooting your own.
  5. Adjust behavior and appearance. The published plan includes "complete control over behavior & appearance," so expect configuration options for how the widget looks and acts. The site does not list the specific settings, so check the FAQ and Meta sites for the current options.

Verify it worked

  • Comments load at the bottom of the page where you placed the embed.
  • The widget feels like part of your site rather than "something bolted on" — that's the stated design goal, so visual mismatch is a signal something needs adjusting.
  • Page load speed stays acceptable. This is the whole point of choosing Remarkbox over ad-supported free systems, so measure before and after.

Common sticking points

"My page is only as fast as my slowest resource." The site makes this argument directly: if you moved to a static site for speed, a heavy comment system undoes that. Remarkbox's stated approach is to stay lean by default and optimize for speed, so if your embed feels slow, check whether you've overridden the defaults.

Free comment systems have a different business model. The site's position is that free systems prioritize ad revenue, "hijacking your traffic and readers," over page speed. If you're comparing options, that's the trade-off being named — not just a price difference.

You may not need a separate forum. Remarkbox "may operate as a forum in stand alone mode." If you want discussion beyond page comments, the site says to reach out to Russell rather than pointing to a self-serve toggle.

Pricing, in the site's own terms

The Plans page lists a Production Yearly option described as "Pay what you can!" at "$0 /mo," with one moderator on a few domains and complete control over behavior and appearance. The site is explicit that it does not set a price and asks you to "contribute what you feel the software and service is worth," framing its model as depending on "reciprocity and trust." Read that literally: $0/mo is the listed figure, and payment is voluntary rather than enforced by a paywall. The site does not document what happens if you contribute nothing, so don't assume feature limits that aren't stated.

Where to go next

  • Demo — see the system running on the site's own pages.
  • FAQ — answers to setup and behavior questions.
  • Meta — the site notes Remarkbox powers its own FAQ and Meta sites, so these double as live examples.
  • Source Code / PyPi — Remarkbox is open source, and both are linked from the site if you want to inspect or self-host.