Back to Docs
Getting started

Your First Site

Create a site in the dashboard, install the embed, choose moderation, and post your first test comment.

1 Site details2 Install3 Verify4 Activate5 Settings6 Test
01

Create the site

Dashboard

Sign in and open Sites → New Site. Enter your site URL and display name, pick up to 3 genres, and note what you are switching from (Disqus, WordPress, none, etc.).

Continue creates the site and issues your Site key — the value used as data-site-id in the embed.

02

Install the snippet

Wizard · Install

On the Install step, pick your platform tab (HTML, Next.js, WordPress, React, …) and copy the snippet. The Site key is shown above the code block.

Place the <script> in your page head (or before </body>) and the #threadline-comments mount where comments should appear. Full options: embed reference.

03

Verify the embed

Wizard · Verify

Threadline checks that the snippet is reachable on your domain. For local development you can continue without a public verify, then re-check before launch.

If verify fails, confirm the page is live, the Site key matches, and nothing is blocking threadline.io/api/embed (CSP, ad blockers, wrong domain).
04

Activate moderation

Wizard · Activate

Choose a moderation preset before going live:

  • Balanced — recommended. New visitors held for review; spam / word filter on.
  • Strict — every comment needs approval; guests off. Best for high traffic.
  • Open — auto-approve everything. Fine for low-spam communities only.

You can also set a theme and an opening discussion prompt on this step, then finish activation.

05

API key and word filter

Site Settings

In Site Settings, reveal and copy the API key anytime — same value as the embed Site key. Treat it like a password; it cannot be rotated from the UI.

Enable Word Filter to auto-flag matching terms. Manage the word list under Moderation → Word Filter. Flagged comments are held for review, not deleted.

06

Post a test comment

Live check

Open a page with the embed, post a short test comment, and confirm it shows in the widget. Then check Moderation — you should see the comment in the queue or activity feed depending on your preset.

Need the short path only? Use Quickstart. Migrating history? See Migrate from Disqus.