# T11: Document "comments disappear when moving embed"

**Status**: resolved
**Priority**: low
**Source**: FAQ `6260e726-d929-11ee-a1b7-751976fc35b2`
**Filed**: 2026-02-01

## Problem

A user moved the Remarkbox embed snippet from one page to another and their comments disappeared from the site (though they still appear on the Remarkbox dashboard). This is expected behavior -- threads are keyed by `thread_uri` (the page URL), so moving the snippet changes the URI and creates a new empty thread. But this isn't documented anywhere.

## Proposed Fix

1. Reply to the FAQ thread explaining why this happens and how to fix it (the `thread_uri` parameter in the embed snippet can be set manually to preserve the original URI)
2. Add a note to the FAQ or docs about this behavior

## Resolution

Documentation added at `docs/thread-uri.md` explaining:
- How threads are keyed by page URL (`thread_uri`)
- Why comments "disappear" when moving an embed (they are still stored, just under the old URL)
- How to use the `thread_uri` parameter to pin comments to a specific URL
- When and how to use manual `thread_uri` (moving content, staging/production, SPAs, URL canonicalization)
- Related namespace settings like "Ignore Query String"

## Draft FAQ Reply

The following reply is ready to post to FAQ thread `6260e726`:

---

Your comments are not lost -- they are still stored under the original page URL. You can see them on your Remarkbox dashboard.

Remarkbox threads are keyed by the page URL (called the `thread_uri`). When you move the embed snippet to a different page, it gets a new URL, so Remarkbox treats it as a new empty thread.

**To fix this**, set the `thread_uri` manually in your embed snippet to the original page URL:

```javascript
var defined_thread_uri = "https://your-site.com/original-page-url";
```

This pins the comment thread to that URL, so your comments will appear no matter where the embed is placed.

We have added documentation about this behavior at `docs/thread-uri.md` in the Remarkbox repository.

---

## Acceptance Criteria

- [x] FAQ thread has a helpful reply
- [x] Documentation explains thread_uri behavior when moving embeds