Annotations

Overview

Annotations (/annotations) is a unified feed of every note you add across Obsurfable. Prompt runs, insights reports, query trees, conversation entries, site analysis reports, and scrapbook entries all support inline annotations—and this page aggregates them into one searchable list with links back to each source.

Use it as team memory: what you found, what you decided, and what to do next—without losing context between Monitor, Act, and Discover sessions.

Who it's for

• Any Obsurfable user (available on Free and Pro) who annotates work across multiple features
• Cross-functional teams where Monitor, content, and community roles need a shared log of observations
• Agencies tracking decisions and follow-ups across client workspaces

Prerequisites

1. A signed-in Obsurfable account.
2. No plan upgrade required—Annotations is available on Free and Pro.
3. At least one annotation created elsewhere in the app (otherwise the feed is empty until you add notes).

Step-by-step

Add annotations where you work

Annotations are created in context—not on the Annotations page itself. Add notes on:

1. Open the relevant page while reviewing results.
2. Click Annotate (or the notes icon) on the section or item you want to remember.
3. Write your note and save—it immediately appears in the Annotations feed.

Browse the Annotations feed

1. Go to Annotations in the sidebar or navigate to /annotations.
2. Scroll the list—newest updates appear based on each note's updatedAt timestamp.
3. Each card shows the source label (e.g., "Insights: Gap 2", "Query: … (node)"), the note text, and a timestamp.
4. Click View page to jump back to the exact source where the annotation was added.

Search and filter

1. Use the Search annotations field to filter by note text, source label, or source type.
2. Use the source type dropdown to narrow to one category—prompt_run, insights_run, query, conversation_entry, site_analysis_run, or scrapbook_entry.
3. Combine search and filter when reviewing a specific sprint or topic.

Use annotations in your workflow loop

1. During Monitor reviews, annotate surprising citations, competitor mentions, or gaps on prompt runs and insights.
2. During Act planning, annotate granular recommendations you are accepting or deferring.
3. During Discover, annotate conversation threads and scrapbook sources with outreach or content angles.
4. Start weekly standups from /annotations—scan recent notes for open follow-ups.

Tips

• Write annotations as actionable notes ("Draft comparison page for X", "Competitor cited in 3/5 runs") rather than vague reminders.
• Use source filters when prepping content sprints—e.g., show only insights_run annotations to build an editorial backlog.
• Annotations on query tree nodes capture URL-matching decisions your team should not re-debate.
• Site analysis annotations are especially useful after IA changes—note which thin clusters you are consolidating.
• If the feed feels empty, add one note on your next prompt run; the habit makes the feed valuable within a week.

FAQ

Is Annotations available on the Free plan?

Yes. Annotations and Scrapbook are available on Free and Pro. Some annotation sources (Insights, Queries, Site analysis, Conversations) require Pro to access the parent feature.

Can I add annotations directly on the Annotations page?

No. Annotations are added in context on prompt runs, insights, queries, conversations, site analysis, and scrapbook. The Annotations page is read-only aggregation with navigation back to sources.

Which features feed into Annotations?

Prompt runs, insights reports, query trees, conversation entries, site analysis reports, and scrapbook entries. Each source type appears with a descriptive label and deep link.

Can I edit or delete an annotation from the Annotations page?

Editing and deleting happen on the source page—open the item via View page, then use the annotate control there. Changes sync to the feed automatically.

Are annotations shared with my team?

Annotations are stored per user and company workspace. Team visibility depends on your account and workspace setup.

How is this different from Scrapbook?

Scrapbook saves external URLs and notes you find on the web. Annotations is the cross-app index of all inline notes—including those on scrapbook entries and every Monitor feature.

Do annotations affect AI recommendations or scores?

No. Annotations are for your team's notes and workflow—they do not change visibility scores, prompt results, or generated insights.