---
title: "Work with Opportunities"
description: "Refresh prioritized SEO findings, understand each detector, inspect evidence, and keep the backlog current."
canonical: "https://crawlraven.com/docs/opportunities"
markdown: "https://crawlraven.com/docs/opportunities.md"
product: "CrawlRaven v2"
last_verified: "2026-08-19"
---

# Work with Opportunities

> Refresh prioritized SEO findings, understand each detector, inspect evidence, and keep the backlog current.

This guide documents current CrawlRaven v2 behavior. UI labels are written exactly where relevant. Bounded Search Console rows are evidence, not guaranteed exhaustive totals.

## Understand the four opportunity types

- **Striking distance:** Queries with meaningful impressions that rank just outside the top results, usually positions 4–20. Strengthen relevance and internal links to push the intended page higher.
- **Query conflict:** Demand is split across several pages instead of one clear owner. Consolidate, differentiate, and point internal links at the intended page.
- **CTR gap:** A query earns fewer clicks than expected for its position. Review intent, title, meta description, and eligible rich-result markup.
- **Content decay:** A page has a sustained click decline versus the comparable period. Review freshness, search intent, and new competitors.

The category tabs show the count for each detector. Use the status control to switch between All, Attention, Resolved, and Ignored findings.

## Refresh and prioritize the backlog

1. **Choose a detection window** — Use the last 28 or 90 days. Changing the window starts a refresh with that evidence period.
2. **Refresh the current window when needed** — Select Refresh opportunities to scan the selected window again. Existing lifecycle state is preserved.
3. **Start with Priority** — Priority combines SEO impact with eligible outcome evidence. SEO impact remains visible separately.
4. **Open the highest useful row** — Select a row to inspect the reason, metrics, trend chart, recommended action, and data coverage.

![CrawlRaven Opportunities table with priority, query, type, metrics, and status](/images/changelog/changelog-opportunities-2026-08-02.png)

*Opportunities are grouped by detector and ranked with the evidence needed to decide what deserves work.*

> **Existing findings survive a refresh problem:** If Google needs reconnection, property access is missing, or Search Console is rate limited, CrawlRaven shows an error and keeps the existing opportunity list available.

## Inspect the evidence drawer

- **Priority, SEO impact, and confidence** are shown separately so you can see why a finding ranks where it does.
- **Reason** explains the measured condition that triggered the finding.
- **Performance slice** charts the specific query or page over 28 days.
- **Competing pages** appears for query conflicts and shows each page’s share.
- **Organic outcome evidence** can show page-level GA4 sessions and key events when a linked property provides a sufficient sample.
- **Recommended action** turns the detector result into a practical next step.

> **GA4 outcome evidence is a page-level proxy:** It helps prioritize pages with demonstrated outcomes, but it is not query-level attribution. Treat it as extra evidence, not proof that one query caused a conversion.

## Manage the opportunity lifecycle

| Action | Use it when |
| --- | --- |
| Pin | The finding matters now and should remain easy to spot. |
| Resolve | The recommended work is complete or the underlying issue no longer needs action. |
| Ignore | The detector is correct, but the finding is not relevant to your strategy. |
| Reopen | A resolved or ignored item needs attention again. |
| Bulk Resolve / Ignore | Several selected rows share the same decision. |

A resolved finding can return when later Search Console evidence detects it again. Use the Returned state as a prompt to verify whether the fix regressed or the search landscape changed. An ignored finding remains ignored. Full workspace access also provides CSV export for the selected status view.

