> ## Documentation Index
> Fetch the complete documentation index at: https://velurahq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Actions: automatic opportunity detection for content and SEO

> Always-on opportunity detection that monitors search performance, AI visibility, and competitors, surfacing issues with evidence and a one-click fix path.

VeluraHQ Actions is an always-on opportunity detection engine. Rather than running manual audits to find what's broken, VeluraHQ watches your search performance, engagement, AI visibility, and competitor activity continuously — and surfaces problems as prioritized, evidence-backed work items the moment they become actionable. The diagnosis travels with the work, so your team spends time executing fixes, not assembling context from disconnected dashboards.

## How Actions works

VeluraHQ monitors four signal types simultaneously across your content:

* **Search performance** — Clicks, impressions, and ranking position over time
* **Site engagement** — Sessions and engagement time, tracking how users interact after they land
* **AI visibility** — Citation share across AI engines and answer platforms, tracking your AI search presence
* **Competitor activity** — Rival page changes, refresh events, and ranking shifts that affect your competitive position

When any of these signals crosses a threshold — a page loses citations, traffic drops 20%, a competitor refreshes a page you're competing with — VeluraHQ generates an Action. Each Action contains:

1. **The evidence** — The specific signals that triggered it, with supporting data
2. **A recommended fix** — A concrete, suggested remediation tied to the signal type
3. **An impact score** — A priority ranking that reflects how much traffic or visibility is at risk
4. **A one-click execution path** — A direct route to the Workflow, Sheet, or Cowork that will fix it

No manual auditing required. You open the Actions queue and see exactly what to work on and why.

## Action types

<CardGroup cols={3}>
  <Card title="Refresh Content" icon="rotate">
    Pages with citation decay, traffic loss, rank drops, or stale evidence. An average of 24 live opportunities surface at any given time — content that still holds authority but needs updating to stay competitive.
  </Card>

  <Card title="New Content" icon="file-plus">
    Topic clusters and prompt gaps where competitors are being cited and you are not. An average of 18 live opportunities identify where a new page or section could capture citations and rankings you're currently missing.
  </Card>

  <Card title="Offsite" icon="arrow-up-right-from-square">
    High-intent community threads and citation opportunities where your brand can add value and earn a mention. An average of 9 live opportunities surface active conversations where you're currently absent.
  </Card>
</CardGroup>

## Priority scoring

Every Action has a **Priority Score** from 0 to 100. Rather than surfacing every possible issue at equal weight, VeluraHQ ranks the queue based on what is most worth your team's time right now. The score is calculated from three factors:

* **Business impact** — How much traffic, rankings, or citations are at risk if the issue goes unaddressed
* **Time sensitivity** — How quickly the situation is deteriorating — a rapidly declining page scores higher than a slowly drifting one
* **Signal confidence** — How reliable the underlying data is — high-confidence signals from multiple sources score higher than single-source signals

<Tip>
  Before committing team capacity to an Action, click it to inspect the full score breakdown. You can see exactly what is driving the priority score — business impact vs. urgency vs. confidence — and why it outranks another Action in the queue. This makes prioritization conversations with your team concrete and evidence-based, not intuition-driven.
</Tip>

## Executing an Action

<Steps>
  <Step title="Open the Actions queue">
    Click **Actions** in your workspace sidebar. The queue shows all open Actions sorted by priority score, with type badges, signal summaries, and scores visible without opening each item.
  </Step>

  <Step title="Filter by type or priority">
    Use the type filter to narrow the queue to **Refresh**, **New content**, or **Offsite** Actions. You can also filter by priority band to focus on high-priority items first.
  </Step>

  <Step title="Read the evidence">
    Click any Action to open its detail panel. Review the evidence that triggered it — the specific signal changes, the timeline, competitor context if relevant — and the recommended fix VeluraHQ has attached.
  </Step>

  <Step title="Choose your execution path">
    Select how you want to execute the fix:

    * **Route to Workflow** — Opens the relevant Workflow with the Action's context pre-filled as inputs. The best path for single-page fixes you want to execute immediately.
    * **Route to Sheet** — Adds the Action and its evidence as a row in a Sheet, ready for bulk execution alongside similar Actions. The best path when you want to batch multiple related Actions together.
    * **Route to Cowork** — Opens Cowork with the Action context loaded, so you can work through the fix conversationally or ask Cowork to build and run the full pipeline.
  </Step>

  <Step title="Execute and track resolution">
    Once you route and execute, the Action moves to **In Progress** status. Track it in the queue until execution completes and the Action moves to **Resolved**.
  </Step>
</Steps>

## Tracking resolution

Each Action moves through three states: **Open → In Progress → Resolved**.

Resolved Actions show the measured impact of the work your team completed — clicks recovered, citations regained, ranking improvements confirmed. This closes the loop between content action and business outcome, giving you a concrete record of what the work was worth.

In the last 30 days, VeluraHQ users resolved 126 Actions with measurable lift, at an average time to fix of 1.4 days from first surfacing to resolution.

<Note>
  VeluraHQ rescores all open Actions daily. An Action that is medium priority today can move to high priority tomorrow if a competitor refreshes a competing page, your citations drop further, or click-through rates fall below a new threshold. Check the queue regularly — the ranking reflects the current state of your competitive landscape, not a snapshot from when the Action was first created.
</Note>
