# Join the contentgrove affiliate program
Source: https://help.contentgrove.io/account/affiliate-program

Join the contentgrove affiliate program and earn 50% recurring commission for every creator you refer, for as long as they stay subscribed.

The contentgrove affiliate program pays recurring commission for every customer you refer, for as long as they stay subscribed.

## Commission

You earn **50% recurring commission for the lifetime of every customer you refer**.

| Referred plan        | Your commission |
| -------------------- | --------------- |
| Monthly (\$29/month) | \$14.50 / month |
| Annual (\$288/year)  | \$144 / signup  |

Because commissions recur, referrals build up over time as long as your referred customers remain active.

## How attribution and payouts work

* **Cookie window:** referrals are attributed for 60 days after someone clicks your link.
* **Dashboard:** track clicks, conversions, and earnings in real time.
* **Payouts:** commissions are paid automatically 15 days after a referred customer's subscription renews. There are no manual payout requests.

## Join

<Steps>
  <Step title="Register">
    Sign up at [contentgrove.endorsely.com](https://contentgrove.endorsely.com/).
  </Step>

  <Step title="Get your link">
    Copy your unique referral link from the affiliate dashboard.
  </Step>

  <Step title="Share it">
    Share it with your audience. Creators who monetize content tend to get real value from contentgrove's analytics, which makes it an easy recommendation.
  </Step>
</Steps>

Questions about the program? Email [info@contentgrove.io](mailto:info@contentgrove.io).


# contentgrove billing, plans, and free trial
Source: https://help.contentgrove.io/account/billing-and-plans

contentgrove plans and pricing, how the free trial works, per-workspace billing, and how to manage or cancel your subscription from Settings.

You manage your subscription in **Settings → Billing**. Billing is handled securely through Stripe.

## Plans

contentgrove is available on a monthly or annual plan. The annual plan is billed once a year and works out cheaper per month than paying monthly.

| Plan    | Price        |
| ------- | ------------ |
| Monthly | \$29 / month |
| Annual  | \$288 / year |

## Workspaces and your bill

Your plan is billed per active [workspace](/concepts/organizations-and-workspaces). One workspace is included; each additional active workspace adds a seat to your subscription. Pausing a workspace stops billing for it and makes it read-only until you resume, and you always keep at least one active workspace. Billing is handled at the organization level, so a single subscription covers all of your workspaces.

## Free trial

New accounts start with a 14-day free trial so you can connect your channel, set up tracking, and see your first results before you pay. Your trial status is shown in **Settings → Billing**.

## Manage your subscription

<Steps>
  <Step title="Open billing settings">
    Go to **Settings → Billing**.
  </Step>

  <Step title="Open the billing portal">
    Open the Stripe billing portal to update your payment method, switch between monthly and annual, view invoices, or cancel.
  </Step>
</Steps>

<Warning>
  If your subscription lapses or is canceled, tracking stops: the script no longer records clicks or conversions. Your existing data remains, but new activity won't be tracked until you resubscribe.
</Warning>

## Questions about billing

For billing questions or help with an invoice, contact [support@contentgrove.io](mailto:support@contentgrove.io).


# Connect contentgrove to Claude or ChatGPT
Source: https://help.contentgrove.io/ai-mcp/connect

Add the contentgrove connector to Claude, ChatGPT, or any MCP client, then sign in so your assistant can read your analytics on request.

You can connect contentgrove to Claude, ChatGPT, or any client that supports remote MCP servers over HTTP. You'll also find this in **Settings → MCP** in contentgrove.

The contentgrove MCP server URL is:

```text theme={null}
https://app.contentgrove.io/api/mcp
```

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="Open Claude connectors">
        In the Claude app or at claude.ai, go to **Settings → Connectors**.
      </Step>

      <Step title="Add the contentgrove connector">
        Add a custom connector, name it **contentgrove**, and paste the server URL above.
      </Step>

      <Step title="Connect and sign in">
        Click **Add → Connect** and sign in with your contentgrove account. You're all set.
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    <Steps>
      <Step title="Open ChatGPT settings">
        In the ChatGPT app or at chatgpt.com, go to **Settings → Apps**.
      </Step>

      <Step title="Create the contentgrove app">
        Turn on **Developer mode**, click **Create app**, name it **contentgrove**, and paste the server URL above.
      </Step>

      <Step title="Connect and sign in">
        Click **Create → Connect** and sign in with your contentgrove account. You're all set.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Other MCP clients">
    <Steps>
      <Step title="Open your client's connectors">
        Find the MCP or connectors section of any client that supports remote MCP servers over HTTP.
      </Step>

      <Step title="Register the server">
        Add an HTTP MCP server with this config:

        ```json theme={null}
        {
          "mcpServers": {
            "contentgrove": {
              "url": "https://app.contentgrove.io/api/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Complete sign-in">
        Finish the OAuth sign-in your client prompts for, using your contentgrove account.
      </Step>
    </Steps>
  </Tab>
</Tabs>

Once connected, head to [What you can ask](/ai-mcp/what-you-can-ask).


# The contentgrove AI connector (MCP)
Source: https://help.contentgrove.io/ai-mcp/introduction

What the contentgrove AI connector is: a read-only Model Context Protocol (MCP) connector that lets AI assistants read your contentgrove analytics.

The contentgrove connector lets an AI assistant read your analytics so you can ask questions in plain language instead of clicking through the dashboard. It's built on the Model Context Protocol (MCP), an open standard that AI clients like Claude and ChatGPT use to connect to external tools.

## How it works

You add contentgrove as a connector in your AI client and sign in with your contentgrove account. From then on, when you ask about your performance, the assistant reads the relevant data and answers.

## Read-only and tied to your account

<Note>
  The connection is read-only and scoped to your own contentgrove account. The assistant can read your analytics, but it can't create, change, or delete anything in contentgrove.
</Note>

## What it can read

* Analytics overview and period-over-period comparisons
* Per-video performance and monetization metrics
* Tracking link performance
* Geography and device breakdowns
* Your offers and their matching rules

## Next step

When you're ready, see [Connect your assistant](/ai-mcp/connect), then [What you can ask](/ai-mcp/what-you-can-ask) for examples.


# What you can ask your AI assistant
Source: https://help.contentgrove.io/ai-mcp/what-you-can-ask

Example questions for the contentgrove connector — from quick performance checks to reports, cross-metric insights, and custom dashboards you build in Claude.

Once your assistant is connected, ask about your performance in plain language. Here are examples grouped by what they read.

## Performance and trends

* "How am I doing this month compared to last month?"
* "What were my total clicks and conversions in the last 30 days?"
* "Is my conversion rate trending up or down?"

These use your analytics overview, including period-over-period comparisons.

## Specific videos

* "Which video drove the most conversions last quarter?"
* "How is my video about \[topic] performing on views, clicks, and revenue?"
* "Compare my top five videos by revenue."

These use per-video performance and monetization metrics.

## Links and offers

* "Which tracking link has the best conversion rate?"
* "List my offers and their landing-page rules."
* "Which links got the most clicks last week?"

These use tracking link performance and your offers.

## Geography and devices

* "Where are my clicks coming from?"
* "Do mobile or desktop viewers convert better?"

These use your geography and device breakdowns. Clicks are broken down by country, and clicks and conversions by device type.

## Go deeper

The assistant can pull your full history and combine metrics across videos, links, and offers, so you can ask for things the dashboard doesn't show directly.

### Reports and summaries

* "Write me a monthly performance report: headline numbers, how they changed versus last month, my top links, and where my clicks come from."
* "Summarize the last 7 days and call out anything unusual."

The assistant has a built-in reporting workflow, so a single request like this pulls the period, compares it to the previous one, and flags dates still inside YouTube's reporting delay.

### Find what to double down on

* "Rank my videos by revenue, then again by revenue per click. Which ones convert efficiently but don't get many clicks yet?"
* "Which offer makes the most money per click?"

Ranking by revenue per click surfaces scaling opportunities — a video or offer that earns well per click but doesn't get many clicks yet is worth pushing to more videos.

### Spot patterns across videos

* "Do my longer videos convert better? Compare average view duration to conversion rate."
* "Which videos get a lot of views but few link clicks? I want to fix their calls to action."
* "Which videos earn the most per view, even if they aren't my most-watched?"

### Understand your audience

* "Which countries drive the most clicks?"
* "What's my click split across mobile, desktop, and tablet?"

## Build dashboards with Claude

In Claude, the assistant can turn any of these answers into an interactive artifact — a chart or a small dashboard you can keep open and refine.

* "Build a dashboard comparing my top 10 videos across views, clicks, conversion rate, and revenue."
* "Chart my daily clicks and conversions over the last 30 days."
* "Make a table of my offers ranked by revenue per click."

<Note>
  Artifacts are a Claude feature. Other clients still answer these questions, but in text or their own formats.
</Note>

## Tips for better answers

* Give a time range ("in May", "last 7 days") when it matters.
* Name a specific video, offer, or link to narrow the answer.
* Ask follow-ups; the assistant can refine within the same conversation.

<Note>
  The connector is read-only, so the assistant can answer and summarize but can't change anything in your account. To create offers or links, use the contentgrove app.
</Note>


# contentgrove analytics metrics explained
Source: https://help.contentgrove.io/analytics/metric-definitions

What each contentgrove metric means and how it's calculated, including YouTube Views, engaged views, clicks, conversions, and revenue.

This page defines the metrics you'll see across the analytics page so you can read them with confidence.

<Info>
  On August 24, 2026, YouTube changed **Views** to count a play from the first frame across all video formats. YouTube renamed its previous view metric **Engaged views**. [Read YouTube's announcement](https://support.google.com/youtube/thread/433409976?hl=en).
</Info>

## Core metrics

| Metric            | Definition                                                                                                                                                                                |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Views**         | Total YouTube play starts. A view is counted from the moment a video begins to play—from the first frame. This is a reach metric and is separate from thumbnail impressions.              |
| **Engaged views** | Views where the viewer continued watching beyond the initial seconds. This is YouTube's previous view-counting metric and contentgrove's primary metric for evaluating video performance. |
| **Clicks**        | Total clicks on your tracking links, excluding detected bots. A click is recorded when someone clicks one of your short links and contentgrove redirects them to your destination.        |
| **Unique clicks** | Clicks from distinct visitors (by IP address), so repeat clicks from the same person count once.                                                                                          |
| **Conversions**   | Completed offers attributed to a prior click, within the 30-day window. See [Conversion tracking](/concepts/conversion-tracking).                                                         |
| **Revenue**       | Total revenue from attributed conversions, based on the revenue you set on each offer.                                                                                                    |

Views tell you how often your videos started playing. Engaged views tell you how often viewers chose to continue watching. contentgrove uses engaged views as the denominator for performance rates so a play that ends immediately does not dilute your click, conversion, and revenue efficiency metrics.

## Rates and derived metrics

| Metric                       | How it's calculated                                                                                                                                                                              |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Engaged view rate**        | Engaged views divided by Views, multiplied by 100 — the percentage of play starts that became engaged views.                                                                                     |
| **Click-through rate (CTR)** | Unique clicks divided by engaged views, multiplied by 100 — how often an engaged view turns into a tracking-link click. This is contentgrove's link CTR, not YouTube's thumbnail-impression CTR. |
| **Views-to-conversion rate** | Conversions divided by engaged views, multiplied by 100 — how often an engaged view ends in a conversion. The existing label is retained for familiarity.                                        |
| **Conversion rate**          | Conversions divided by unique clicks, multiplied by 100 — how often a distinct clicker converts.                                                                                                 |
| **Revenue per view**         | Revenue divided by engaged views — the average revenue generated per engaged view. The existing label is retained for familiarity.                                                               |
| **Revenue per click**        | Revenue divided by unique clicks — the average revenue for each person who clicked your link.                                                                                                    |
| **Engagement score**         | Likes, comments, and shares divided by engaged views, shown per 1,000 engaged views. Use it to compare viewer interaction across videos of different sizes.                                      |
| **Click score**              | Tracking-link clicks divided by engaged views, shown per 1,000 engaged views.                                                                                                                    |
| **Watch depth**              | A comparison of how long viewers watch, based on YouTube's average view duration.                                                                                                                |
| **Funnel efficiency**        | How effectively each stage of the funnel (**Views → Engaged views → Clicks → Conversions**) carries through to the next.                                                                         |

<Note>
  If YouTube does not return engaged views for a historical date, contentgrove uses Views as a fallback for that date. This keeps historical reporting continuous and can make the two metrics appear equal.
</Note>

## Period comparison

Where contentgrove shows a change versus the previous period, it compares the selected range against the equivalent range immediately before it, so you can see whether a metric is trending up or down.

## Data freshness

Clicks, conversions, and revenue come from contentgrove's own tracking and are available without YouTube's reporting delay. Views, engaged views, and other video metrics come from YouTube, which can lag by up to 72 hours. The most recent few days may rise as YouTube finalizes its reporting.

<Tip>
  When a recent-day number looks low, check whether it falls inside YouTube's reporting delay before drawing conclusions.
</Tip>


# Read your contentgrove analytics dashboard
Source: https://help.contentgrove.io/analytics/overview

A tour of the contentgrove analytics dashboard: summary metrics, the charts and data views, every chart explained, and the sortable video table.

The **Analytics** page brings your YouTube views together with the clicks, conversions, and revenue your videos generate. This is a tour of what you'll find; for precise definitions, see [Metric definitions](/analytics/metric-definitions).

<Frame>
  <iframe title="Understanding analytics in contentgrove" />
</Frame>

## Summary metrics

At the top, four cards summarize the selected period:

<CardGroup>
  <Card title="Views" icon="eye">YouTube views for your videos.</Card>
  <Card title="Clicks" icon="arrow-pointer">Clicks on your tracking links.</Card>
  <Card title="Conversions" icon="circle-check">Completed offers attributed to your videos.</Card>
  <Card title="Revenue" icon="dollar-sign">Revenue from attributed conversions.</Card>
</CardGroup>

## Filters

Use the filters bar to set the date range and narrow results, for example by offer or link. The whole page — summary cards, charts, and the video table — updates to match.

## Charts and data views

A toggle in the filters bar switches how the page below the summary cards is shown:

* **Charts view** — the visual dashboard: charts, per-video cards, and geography and device breakdowns. Best for spotting trends and comparing videos at a glance.
* **Data view** — a sortable table with one row per video, carrying the full set of metrics side by side. Best for ranking videos and reading exact numbers.

The summary cards stay at the top in both views.

## Charts view

### Analytics overview

An area chart plotting **views, clicks, and conversions** day by day across the selected period, so you can see trends and spikes. Views use the left axis; clicks and conversions use the right. Days still inside YouTube's reporting delay are shaded to show those numbers may still rise.

### Video performance analysis

A scatter chart where each bubble is a video, placed by its **views** (left to right) and **conversion rate** (bottom to top). Bubble size and color intensity show **revenue**, so your high-view, high-converting, high-earning videos stand out toward the top right.

### Top 5 videos by revenue

A bar chart of your five highest-earning videos in the period — a quick read on what's making the most money.

### Conversion funnel

Shows how your audience narrows through the three tracked stages — **views → clicks → conversions** — with the drop-off at each step, so you can see where you're losing people.

### Clicks vs. engagement score

A bar chart comparing each video's **engagement score** (likes, comments, and shares per 1,000 views) with its **click score** (link clicks per 1,000 views). A gap between the two flags videos that engage viewers but don't drive clicks, or the reverse.

### Geography and devices

Below the charts, **Top countries by clicks** ranks where your clicks come from, and **Device type by clicks** splits them across desktop, mobile, and tablet. Both come from contentgrove's own click data.

## Data view

Switch to data view for a sortable table with one row per video (and per bio link). Alongside views, clicks, and conversions, each row carries the full metric set: CTR, unique clicks, views-to-conversion rate, revenue, conversion rate, revenue per view, revenue per click, plus YouTube stats like watch time, average view duration, subscribers gained, likes, shares, and comments.

* **Sort by any metric** — click a column header to sort by it; click again to reverse. The table opens sorted by clicks, highest first.
* **Manage conversions** — open a row's menu to review the conversions recorded for that video and add or remove one by hand.
* **Reset tracking data** — editors can clear all clicks and conversions for a video or bio link. This can't be undone.

For what each column means and how it's calculated, see [Metric definitions](/analytics/metric-definitions).

<Note>
  YouTube can delay its reporting by up to 72 hours, so view-based metrics for the last few days may be incomplete and rise later. Click, conversion, and revenue data from contentgrove is not subject to that delay.
</Note>

## Make decisions from it

Compare videos to learn which topics and formats convert best, then put your best-performing links in more videos. Data view is the fastest way to do this — sort by revenue per click or conversion rate to find your most efficient videos. For the meaning of every metric, see [Metric definitions](/analytics/metric-definitions).


# How clicks and conversions are counted
Source: https://help.contentgrove.io/concepts/clicks-and-conversions

Understand what makes a click and a conversion count in contentgrove, why conversions need an offer, and how URL match types decide whether a page counts.

Every number in contentgrove comes down to two events: a **click** and a **conversion**. Knowing exactly what makes each one count explains the rest of your setup.

## What counts as a click

A click is recorded the moment someone clicks one of your tracking links. contentgrove counts it server-side at the short-link redirect, before your landing page even loads.

Because the click is tied to the link itself:

* **Every tracking link counts clicks** — whether it's an offer link or an affiliate link. You don't need an offer to count clicks.
* The click is recorded even if your tracking script isn't installed on the destination page. The script is what later links a click to a conversion, not what counts the click.

Obvious bot traffic is filtered out, and clicks are only recorded while your subscription is active.

## What counts as a conversion

A conversion needs an **offer**. An offer defines your landing page and, most importantly, your **thank-you page** — the page a visitor reaches after completing your action, such as a purchase, signup, or booking.

A conversion is counted when both of these are true:

* The visitor **previously clicked** a link tied to that offer, within the last 30 days.
* They reach a page that **matches the offer's thank-you page rule**.

<Warning>
  A tracking link on its own only counts clicks. To count conversions and revenue, the link must point to an **offer** that has your landing and thank-you page URLs set up. Without an offer, contentgrove never records a conversion. See [Set up offers](/links/offers).
</Warning>

The conversion is linked back to the original click and video, so you can see the full path from video to click to conversion. See [Conversion tracking](/concepts/conversion-tracking) for how attribution and the 30-day window work.

## How contentgrove matches your pages

When you set up an offer, you choose a **match type** for each URL. This is how contentgrove decides whether the page a visitor is on counts as your landing or thank-you page.

| Match type       | Behavior                                        | Example                                                                       |
| ---------------- | ----------------------------------------------- | ----------------------------------------------------------------------------- |
| **Exact match**  | The URL must match exactly.                     | `yoursite.com/landing` matches only that URL.                                 |
| **Includes**     | The URL contains your pattern anywhere.         | `/landing` matches `yoursite.com/landing` and `yoursite.com/my-landing-page`. |
| **Not Includes** | The URL does not contain your pattern anywhere. | `/offer` matches `yoursite.com/landing` but not `yoursite.com/landing-offer`. |
| **Starts with**  | The URL begins with your pattern.               | `yoursite.com/landing` matches `yoursite.com/landing?utm_source=youtube`.     |
| **Ends with**    | The URL ends with your pattern.                 | `/thank-you` matches `yoursite.com/product/thank-you`.                        |

### Which to choose

* **Thank-you page** — this is the match that determines conversions, so it matters most. Use **Includes** for flexibility, or **Starts with** to target a specific page. Avoid an overly strict **Exact match**, a common reason conversions don't record.
* **Landing page** — **Starts with** is usually best, because it still matches when tracking parameters are appended to the URL.

<Tip>
  After setting up an offer, test the whole flow: click a tracking link, complete your action, and confirm both the click and the conversion appear in your dashboard. If the conversion doesn't show, your thank-you page match type or pattern is probably too strict.
</Tip>


# How conversion tracking works
Source: https://help.contentgrove.io/concepts/conversion-tracking

How contentgrove records conversions: when a conversion counts, how it's attributed to the original click and video, and the identifier you see.

A conversion is recorded when someone who clicked a tracked link reaches a thank-you page that matches one of your offers. This page explains when conversions are counted and what information you see.

## When a conversion is counted

A conversion is recorded when all of these are true:

* The page matches a thank-you page pattern on one of your [offers](/links/offers).
* The visitor previously clicked a tracked link, within the last 30 days.
* Consent is granted, if you use a consent management platform.
* Your subscription is active.

The conversion is linked back to the original click and video, so you can see the full path from video to click to conversion.

<Note>
  Refreshing a thank-you page won't double-count. Each click results in at most one conversion.
</Note>

## What gets recorded

For each conversion, contentgrove records which video led to it, which offer was completed, the revenue (if set on the offer), and when it happened.

## Managing conversions

Every conversion appears in the analytics data view, where you can adjust it or add ones that weren't tracked automatically. On the **Analytics** page, open the data view and choose **Manage conversions** on any video or bio link row.

From there you can:

* **Add a manual conversion** — record a sale that happened outside your tracked pages. Pick the offer, set the revenue and the date and time it happened, and add an optional note.
* **Edit a conversion** — change the offer, revenue, or timestamp on any conversion, whether it was tracked automatically or added manually.
* **Remove a conversion** — hide it from analytics. Removed conversions are kept and can be restored later, so nothing is permanently lost.

<Info>
  Adding, editing, and removing conversions requires an Editor, Admin, or Owner role in the workspace. See [Roles and permissions](/concepts/roles-and-permissions).
</Info>

## Conversion identifier

Some thank-you page URLs include a useful, privacy-safe value that identifies the conversion, such as a name, email, or a Stripe session ID. When one is present, contentgrove surfaces a best-available identifier on the conversion in your analytics, so you can recognize individual conversions without integrating directly with your payment or booking platform.

contentgrove only captures a small, allowlisted set of fields and ignores free-text or sensitive values. The best identifier is chosen in this order: name, then email, then phone, then a Stripe session ID, then a booking reference.

<Note>
  Manual conversions you add yourself don't get an automatic identifier.
</Note>

## If conversions aren't recording

The most common causes are the thank-you page URL not matching your offer pattern, the tracking script missing from the thank-you page, or the 30-day window having passed. See [Conversions aren't being attributed](/troubleshooting/conversions-not-attributed).


# How contentgrove tracking works
Source: https://help.contentgrove.io/concepts/how-tracking-works

Understand how contentgrove tracking works: the click-to-conversion flow, what data gets recorded, and how clicks are linked back to conversions.

contentgrove tracking connects a click on one of your video links to a conversion on your site. This page explains the flow so the rest of the setup makes sense.

## The flow

<Steps>
  <Step title="A viewer clicks your link">
    Someone clicks one of your contentgrove short links (like `grve.to/free-course`) in your video description or comment. contentgrove records the click and which video it came from, then redirects the visitor to your destination.
  </Step>

  <Step title="Your landing page loads">
    The tracking script on your landing page picks up the attribution the short link passed along.
  </Step>

  <Step title="A click ID is stored">
    The script stores a click ID in the visitor's browser for 30 days, so a later conversion can be linked back to this click.
  </Step>

  <Step title="The visitor converts">
    They complete your action and reach your thank-you page.
  </Step>

  <Step title="The conversion is recorded">
    The script on your thank-you page records a conversion and links it back to the original click and video.
  </Step>
</Steps>

## What gets recorded

When someone clicks a tracked link, contentgrove records which video they came from, which landing page they visited, their device type, their city and country, and when the click happened.

When someone converts, it records which video led to the conversion, which offer they completed, the revenue (if you set it on the offer), and when it happened.

<Note>
  contentgrove doesn't collect personal information like names or emails. IP addresses are used only to derive city and country. Some thank-you page URLs include identifier values (for example a Stripe session ID), and contentgrove can surface a best-available identifier on a conversion. See [Conversion tracking](/concepts/conversion-tracking).
</Note>

## How clicks link to conversions

The click ID is stored for **30 days**. If a visitor clicks a link and converts within that window, the conversion is attributed to the original click and video. If they convert after 30 days, or in a different browser, the conversion can't be linked back.

If a visitor refreshes your thank-you page, the conversion isn't counted twice. Each click can result in at most one conversion.

## Consent mode

<Warning>
  The script does not wait for consent unless you turn on strict consent mode. If you're subject to GDPR or similar rules, add `data-require-consent="true"` so tracking only fires after the visitor opts in.
</Warning>

By default, the tracking script records clicks and conversions as soon as it loads, without waiting for a consent signal.

To make tracking wait for visitor consent, turn on **strict consent mode** by adding `data-require-consent="true"` to the script tag (or `requireConsent: true` in the window config):

```html theme={null}
<script
  src="https://cdn.contentgrove.workers.dev/cg-tracker.js"
  data-tracking-id="YOUR_TRACKING_ID"
  data-require-consent="true"
  async
></script>
```

In strict consent mode:

* The script tracks **only after** the visitor grants consent through a supported consent platform — Cookiebot, CookieYes, CookieScript, OneTrust, or the WordPress Consent API.
* Until consent is granted, nothing is recorded. The attribution is held in the browser's memory and tracking fires automatically the moment consent is given.
* If no supported consent platform is present on the page, tracking stays blocked.

## Subscription

Tracking runs only while your subscription is active. If it lapses, the script stops making tracking requests.

## Next step

Ready to add the script? See [Install the tracking script](/tracking/install-script), or jump to your platform's guide under [Supported platforms](/tracking/supported-platforms).


# How organizations and workspaces work
Source: https://help.contentgrove.io/concepts/organizations-and-workspaces

How organizations, workspaces, and channels fit together in contentgrove, what stays separate between them, and when to use more than one workspace.

contentgrove organizes your account into three levels: an organization, one or more workspaces, and the channels connected inside each workspace. Most people never think about this — if you're a solo creator, you have one organization, one workspace, and one channel, and everything just works. The structure only starts to matter once you add more brands, clients, or teammates.

## The three levels

| Level            | What it is                                                                                              | Holds                           |
| ---------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------- |
| **Organization** | The account that pays. Your subscription and billing live here.                                         | One or more workspaces          |
| **Workspace**    | A single brand. Its analytics, links, offers, and members are kept separate from every other workspace. | One or more channels + members  |
| **Channel**      | A connected YouTube account.                                                                            | Its videos and performance data |

You always work inside a workspace. The organization sits above it and handles billing; the channels sit inside it and supply the YouTube data.

## What's shared and what's separate

* **Separate per workspace:** analytics, tracking links, offers, custom domains, and the list of members. Data from one workspace never mixes into another.
* **Shared across the organization:** billing and organization membership. One subscription covers all of the organization's workspaces.
* **Organization owners and admins** can open any workspace in the organization. A workspace's own members only see the workspaces they've been added to.

## When to use more than one workspace

Most creators only ever need one. Consider a second workspace when you want to keep results fully separate:

* **Solo creator:** one workspace. If you run more than one YouTube channel for the same brand, connect them all as channels inside that single workspace.
* **Consultant or agency:** one workspace per client, so each client's analytics, links, and access stay isolated. Switch between them from the workspace switcher.
* **Multiple brands:** one workspace per brand.

<Note>
  Each active workspace is billed as a seat on your plan. Adding a workspace adds to your subscription; pausing one stops billing for it. See [Billing & plans](/account/billing-and-plans).
</Note>

## Create and switch workspaces

<Steps>
  <Step title="Open the workspace switcher">
    Select your current workspace name in the top navigation to open the switcher. It lists every workspace you can access.
  </Step>

  <Step title="Create a workspace">
    Choose **Create workspace**, give it a name, and confirm. The new workspace is added to your organization and appears in the switcher.
  </Step>

  <Step title="Switch between workspaces">
    Select any workspace in the switcher to move into it. The dashboard, links, and analytics all update to that workspace.
  </Step>
</Steps>

## Common questions

<AccordionGroup>
  <Accordion title="Do I need to set up an organization?">
    No. Your organization is created for you when you sign up. With a single workspace you won't even see it as a separate area — settings simply show a **Billing** section. The dedicated **Organization** settings appear only once you have more than one workspace.
  </Accordion>

  <Accordion title="Can one workspace have more than one YouTube channel?">
    Yes. A workspace can hold several channels, and their data is aggregated within that workspace. Connect them under **Settings → Channels**.
  </Accordion>

  <Accordion title="Can someone be in more than one workspace?">
    Yes. A person can be a member of several workspaces, each with their own role. See [Roles & permissions](/concepts/roles-and-permissions).
  </Accordion>

  <Accordion title="Is my data separated between workspaces?">
    Yes. Analytics, links, offers, and members are scoped to a single workspace and never shared with another.
  </Accordion>
</AccordionGroup>

## Next step

<Card title="Roles and permissions" icon="user-lock" href="/concepts/roles-and-permissions">
  See what each organization and workspace role can do, and how to invite teammates.
</Card>


# Roles and permissions
Source: https://help.contentgrove.io/concepts/roles-and-permissions

The contentgrove organization and workspace roles, a capability matrix of what each role can do, and how to invite teammates to a workspace.

contentgrove uses two sets of roles: one at the organization level, which controls billing and access across workspaces, and one at the workspace level, which controls day-to-day work inside a single brand. A person can hold different roles in different workspaces.

## Organization roles

Organization roles decide who pays, who manages workspaces, and who can reach every workspace in the organization.

| Role       | What it can do                                                                                                                                        |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Owner**  | Everything an admin can, and is the top role for the organization.                                                                                    |
| **Admin**  | Manage billing and the subscription, create, pause, and delete workspaces, and open any workspace in the organization.                                |
| **Member** | Belongs to the organization but has no billing access and no automatic access to its workspaces — only the workspaces they've been added to directly. |

The key difference: an organization **owner or admin can open any workspace in the organization** without being added to it. An organization **member cannot** — they only see workspaces where they hold a workspace role.

## Workspace roles

Workspace roles control what someone can do inside a single workspace.

| Capability                         | Viewer | Editor | Admin | Owner |
| ---------------------------------- | :----: | :----: | :---: | :---: |
| View analytics, links, and offers  |    ✓   |    ✓   |   ✓   |   ✓   |
| Create and edit links and offers   |        |    ✓   |   ✓   |   ✓   |
| Set up tracking and custom domains |        |    ✓   |   ✓   |   ✓   |
| Connect and remove channels        |        |        |   ✓   |   ✓   |
| Invite and manage members          |        |        |   ✓   |   ✓   |
| Rename the workspace               |        |        |   ✓   |   ✓   |

<Note>
  Billing, and creating or removing workspaces, are handled at the organization level (Owner or Admin), not inside a workspace. See [How organizations and workspaces work](/concepts/organizations-and-workspaces).
</Note>

## Invite teammates

Workspace admins and owners can invite people into a workspace and choose their role.

<Steps>
  <Step title="Open members settings">
    Go to **Settings → Members** in the workspace you want to add someone to.
  </Step>

  <Step title="Send an invite">
    Enter the person's email, pick a role (Viewer, Editor, or Admin), and send. They receive an email with a link to accept.
  </Step>

  <Step title="They accept">
    When they accept, they join the workspace with the role you chose. If they don't have a contentgrove account yet, they create one from the invite.
  </Step>
</Steps>

<Note>
  Someone who joins only through an invitation gets a seat in your workspace — they don't get their own workspace, free trial, or separate bill. Their access comes from the organization that invited them.
</Note>

## Common questions

<AccordionGroup>
  <Accordion title="Can one person have different roles in different workspaces?">
    Yes. Roles are set per workspace, so you can be an admin in one and a viewer in another.
  </Accordion>

  <Accordion title="Who can change the subscription?">
    Organization owners and admins. Billing lives at the organization level, not inside a workspace.
  </Accordion>

  <Accordion title="Can an admin see a workspace they weren't added to?">
    An organization owner or admin can open any workspace in the organization. A workspace admin only sees the workspaces they belong to.
  </Accordion>

  <Accordion title="How do I remove someone?">
    A workspace admin or owner can remove a member from **Settings → Members**.
  </Accordion>
</AccordionGroup>

## Next step

<Card title="Organizations and workspaces" icon="sitemap" href="/concepts/organizations-and-workspaces">
  See how the organization, workspaces, and channels fit together.
</Card>


# Connect your YouTube account
Source: https://help.contentgrove.io/getting-started/connect-youtube

Connect your YouTube channel to contentgrove with read-only access, so it can sync your videos and pull their performance data automatically.

Connecting your channel lets contentgrove sync your videos and pull their performance metrics. The connection is read-only.

## Connect your channel

<Steps>
  <Step title="Start the connection">
    On your dashboard, click **Connect YouTube**.

    <Frame>
      <img alt="The Connect YouTube button on the contentgrove settings page" />
    </Frame>
  </Step>

  <Step title="Sign in with Google">
    Sign in with the Google account that owns your channel.
  </Step>

  <Step title="Grant access">
    Approve access to your YouTube analytics.

    <Frame>
      <img alt="Google consent screen granting contentgrove access to YouTube analytics" />
    </Frame>
  </Step>

  <Step title="Let your videos sync">
    Your videos and their metadata import automatically and appear in contentgrove.
  </Step>
</Steps>

<Tip>
  You can connect more than one channel to the same workspace from **Settings → Channels**, and their data is combined in that workspace. See [How organizations and workspaces work](/concepts/organizations-and-workspaces).
</Tip>

## What contentgrove can and can't do

<Note>
  contentgrove only reads from your channel. It never posts, deletes, or edits your content on its own. The one exception is optional: when you generate a tracking link, you can choose to have contentgrove add or update that link in the video's description.
</Note>

## A note on data freshness

YouTube's own reporting pipeline can delay metrics by up to 72 hours. Numbers for the most recent few days, such as views, watch time, and subscribers, may be incomplete at first and rise later as YouTube finalizes them.

## Refresh your data

contentgrove syncs automatically, but you can pull the latest titles, thumbnails, and descriptions on demand using **Refresh video descriptions** in the [Create links](/links/create-links) tab. Use it after you upload new videos or edit descriptions directly on YouTube.

If your channel isn't showing the right videos, see [My video isn't showing up](/troubleshooting/video-not-showing).


# Set up contentgrove tracking in 5 minutes
Source: https://help.contentgrove.io/getting-started/quickstart

Get started with contentgrove: connect YouTube, install the tracking script, and create your first tracking link in about five minutes.

This walkthrough takes you from a new account to a working tracking link with live analytics. Set aside about five minutes.

## 1. Connect your YouTube account

After signing up, connect the channel you want to measure.

<Steps>
  <Step title="Start the connection">
    In your Settings, click **Connect YouTube**.
  </Step>

  <Step title="Sign in with Google">
    Choose the Google account that owns your channel and grant access to your YouTube analytics.
  </Step>

  <Step title="Grant access">
    Approve access to your YouTube analytics.
  </Step>
</Steps>

<Note>
  contentgrove only reads data from your channel. It never posts or changes your content, unless you explicitly ask it to update a video description when generating a link.
</Note>

## 2. Add the tracking script

To record clicks and conversions, add the tracking script to your landing and thank-you pages.

<Steps>
  <Step title="Open tracking settings">
    Go to **Settings → Tracking**.
  </Step>

  <Step title="Choose your platform">
    Select the platform your site is built on (WordPress, Shopify, Webflow, Google Tag Manager, and more). contentgrove gives you a ready-made snippet for it, with your Tracking ID already filled in.
  </Step>

  <Step title="Add the snippet to your site">
    Copy the snippet contentgrove shows and paste it just before the closing `</body>` tag, on both your landing pages and your thank-you pages. The script tag looks like this:

    ```html theme={null}
    <script
    	src="https://cdn.contentgrove.workers.dev/cg-tracker.js"
    	data-tracking-id="YOUR_TRACKING_ID"
    	async
    ></script>
    ```
  </Step>
</Steps>

<Tip>
  Using Google Tag Manager or a website builder? See [Install the tracking script](/tracking/install-script) for platform-specific guides.
</Tip>

## 3. Create your first offer

An offer tells contentgrove which pages are landing pages and which represent a successful conversion.

<Steps>
  <Step title="Open offers">
    Go to the **Offers** page and click **Create offer**.
  </Step>

  <Step title="Describe the offer">
    Give it a name (for example, "Filmmaking Course"), then set your landing page and thank-you page URLs and how each should match. See [how clicks and conversions are counted](/concepts/clicks-and-conversions).
  </Step>

  <Step title="Save it">
    Click **Create**.
  </Step>
</Steps>

## 4. Generate a tracking link

<Steps>
  <Step title="Open Create links">
    On the **Links** page, open the **Create links** tab.
  </Step>

  <Step title="Set the destination and video">
    Enter your destination URL and pick the YouTube video you're promoting.
  </Step>

  <Step title="Generate and copy">
    Click **Generate link** and copy the result. Add it to your video description, pinned comment, or anywhere you send viewers.
  </Step>
</Steps>

For all the options, see [Generate Tracking Links](/links/create-links).

## 5. View your analytics

Open the **Analytics** page to see clicks, conversions, conversion rate, and your top-performing videos. Data appears as clicks and conversions come in. For what each number means, see [Metric definitions](/analytics/metric-definitions).

## Setup checklist

Once all four are done, you're ready to make decisions based on what actually converts.


# Manage all your tracking links
Source: https://help.contentgrove.io/links/all-links

View, search, filter, and manage every contentgrove tracking link in one place, grouped by the video each one points to, from the All Links tab.

The **All links** tab shows every tracking link you've created, grouped by the YouTube video it belongs to. Use it to find a link, check its clicks, or manage it.

## How links are organized

Each video appears as a card you can expand to see its links. A collapsed card shows the video thumbnail, title, and link count. Expand it to see each link's details and actions. [Bio links](/links/create-links#link-type) are gathered into their own **Bio links** group rather than under a video.

For each link you'll see:

* **Short URL** — the link you share
* **Destination URL** — where it points
* **Clicks** — total clicks, updated as they come in
* **Created date**
* **Link type** — Offer or Affiliate
* **Template name** — if it came from a [dynamic link](/links/dynamic-links)
* **Offer name** — if it's an offer link

## Find a link

* **Search** the bar by video title, destination URL, short URL, template name, or offer name. Results filter as you type.
* **Filter** by type: **All links**, **Dynamic links** (created from a template), or **Manual links** (created directly in Create links).

## Actions

<AccordionGroup>
  <Accordion title="Copy">
    Copy the short URL to your clipboard.
  </Accordion>

  <Accordion title="Replace">
    Create a new link to take over from the current one, for example to change the destination. You can then update the YouTube description with the new link.
  </Accordion>

  <Accordion title="View analytics">
    Open detailed performance for the link, including clicks over time and conversions for offer links.
  </Accordion>

  <Accordion title="Delete">
    Permanently remove a link. Once deleted, it stops tracking clicks.
  </Accordion>
</AccordionGroup>

<Warning>
  Deleting a link is permanent. Make sure you no longer need it before confirming.
</Warning>

## If a link isn't showing

A link may be hidden by an active filter or search, or it may not have been created yet. Select the **All links** filter, clear the search bar, and check the right video card. If you still can't find it, create it in [Create links](/links/create-links).


# The contentgrove Chrome extension
Source: https://help.contentgrove.io/links/browser-extension

Connect the contentgrove Chrome extension to generate tracking links right inside YouTube while you write and edit your video descriptions.

The contentgrove Chrome extension lets you create and manage tracking links without leaving YouTube. It adds a side panel to YouTube Studio so you can generate a tracked link and drop it into your description while you write. You connect it once to your contentgrove account, then it works alongside your normal workflow.

<Frame>
  <img alt="The contentgrove side panel open in YouTube Studio, generating a tracking link for the current video" />
</Frame>

## Install the extension

<Card title="Add contentgrove to Chrome" icon="chrome" href="https://chromewebstore.google.com/detail/contentgrove/mcgfnndoghidomkleahmhklgkicicbpp">
  Install the extension from the Chrome Web Store, then pin it to your toolbar.
</Card>

## Connect it to your account

The extension connects to contentgrove using a one-time approval in your browser.

<Steps>
  <Step title="Open the extension">
    Click the contentgrove icon in your browser toolbar and choose **Connect**.
  </Step>

  <Step title="Sign in to contentgrove">
    A contentgrove page opens. Sign in with your account if you aren't already.
  </Step>

  <Step title="Approve the connection">
    Confirm the connection to link the extension to your account. You only do this once.
  </Step>
</Steps>

<Note>
  If you're signed out when you approve, contentgrove sends you to the login page first and returns you to the approval step automatically.
</Note>

## What you can do with it

From the side panel in YouTube Studio, you can:

* Generate a tracked link for the **current video**, for **all matching videos**, or for your **bio** — without leaving YouTube.
* Insert the link straight into the description editor. The existing URL in your description is replaced automatically, so there's no copy-paste between tabs.
* Choose an **offer link** (to track conversions) or an **affiliate link** (to track clicks). See [Offers](/links/offers).
* Use your own [custom domain](/links/custom-domains) and a custom back-half for a branded, memorable link.

For the full set of link options and how they work, see [Create links](/links/create-links).


# Generate tracking links for your videos
Source: https://help.contentgrove.io/links/create-links

Generate contentgrove tracking links for one video or all of them at once, and manage your video descriptions in bulk from the Create links tab.

The **Create links** tab is your main workspace for creating tracking links. Generate a link for a single video, or generate links across all videos that point to the same destination. The tab has two sides: link generation on the left, bulk actions on the right.

<Frame>
  <iframe title="How to create tracking links in contentgrove" />
</Frame>

## Generate a tracking link

<Steps>
  <Step title="Enter a destination URL">
    Type the URL where you want to send traffic, usually your landing page. The field validates as you type and adds `https://` if you leave it off.

    <Frame>
      <img alt="Entering a destination URL in the Create links tab" />
    </Frame>
  </Step>

  <Step title="Select a video">
    Choose a single video, or switch to **All videos** mode (see below).

    <Frame>
      <img alt="Selecting a YouTube video to create a tracking link for" />
    </Frame>
  </Step>

  <Step title="Configure link settings">
    Pick the link type, the domain, and an optional custom back-half.

    <Frame>
      <img alt="Choosing an offer or affiliate link type for the tracking link" />
    </Frame>
  </Step>

  <Step title="Generate">
    Click **Generate link**, then copy the result.
  </Step>
</Steps>

### Single video vs all videos

Use the toggle in the video step to switch modes:

* **Single video** — create one link for a specific video. You can set a custom back-half and optionally auto-update that video's description.
* **All videos** — contentgrove finds every video whose description contains the destination URL and creates a unique link for each. Custom back-halves are off in this mode (links are auto-generated), and descriptions are updated automatically.

<Note>
  All-videos mode relies on the destination URL already appearing in each video's description.
</Note>

### Link type

* **Offer link** — tied to a specific offer, so conversions are tracked. Select the offer from the dropdown (you can create one inline). See [Offers](/links/offers).
* **Affiliate link** — a general tracking link with no offer, so it tracks clicks only.
* **Bio link** — a link for your YouTube channel bio rather than a specific video. Bio links are grouped separately in the [All links](/links/all-links) tab and in analytics.

### Short link builder

Choose which **domain** to use, and in single-video mode set a **custom back-half** for a memorable URL.

| Part             | Example                         |
| ---------------- | ------------------------------- |
| Domain           | `track.example.com`             |
| Custom back-half | `free-course`                   |
| **Result**       | `track.example.com/free-course` |

### Auto-update YouTube description

In single-video mode, check the auto-update box to update the video's YouTube description directly. This only works when the destination URL is already in the description — contentgrove replaces that URL with your new tracking link rather than appending a new one. In all-videos mode, matching descriptions update automatically.

## Bulk actions

The right column handles your videos and links at scale.

<AccordionGroup>
  <Accordion title="Replace links in descriptions">
    Swap an existing link — like a genius link or a Bitly link — for another one across all your YouTube video descriptions. Useful when you're migrating off a third-party shortener before you create tracking links.
  </Accordion>

  <Accordion title="Refresh video descriptions">
    Re-sync titles, thumbnails, descriptions, and other metadata from YouTube. Use it after uploading new videos, editing descriptions on YouTube, or if you notice a mismatch.
  </Accordion>

  <Accordion title="Verify links in descriptions">
    Check that each tracking link is still present in its video's description, so you can catch links that were accidentally removed.
  </Accordion>
</AccordionGroup>

## Tips

* Test your destination URL before generating links.
* Use descriptive custom back-halves so links are easy to recognize.
* Use auto-update when generating a single-video link to drop the tracking link straight into that video's description — it replaces the destination URL you already placed there.
* Use all-videos mode only when the destination URL is already in each description.

To view and manage what you've created, see [All links](/links/all-links).


# Set up a custom domain for your links
Source: https://help.contentgrove.io/links/custom-domains

Use your own domain for branded contentgrove tracking links, so your short links match your brand instead of the default contentgrove domain.

A custom domain lets your tracking links use your own branding (for example `track.yoursite.com/abc123`) instead of a shared domain. You set this up in **Settings → Custom domain**.

<Frame>
  <iframe title="How to set up custom domains in contentgrove" />
</Frame>

## Add a custom domain

<Steps>
  <Step title="Open custom domain settings">
    In contentgrove, go to **Settings → Custom domain**.
  </Step>

  <Step title="Enter a subdomain">
    Enter the subdomain you want to use for links, such as `go.yourdomain.com` or `track.yourdomain.com`. Use a subdomain, not your root domain (`yourdomain.com`) — your root domain should keep pointing at your main website.
  </Step>

  <Step title="Copy your DNS records">
    After you add the domain, open **DNS Config** on the domain card. contentgrove shows the exact records to add: a **TXT record** to verify you own the domain, and a **CNAME record** that routes the subdomain to contentgrove. The exact names and values are generated for your domain, so copy them from this screen.
  </Step>

  <Step title="Add the records at your DNS provider">
    Sign in to your domain provider (for example Cloudflare, GoDaddy, or Namecheap) and add the TXT and CNAME records exactly as shown, matching the type, name/host, and value for each.
  </Step>

  <Step title="Verify">
    Back in **Settings → Custom domain**, click **Verify**. Once your DNS has propagated, contentgrove confirms the domain and it becomes available for links.
  </Step>
</Steps>

### What the records look like

contentgrove generates a unique verification value and routing target for each domain, so **always copy the exact records from DNS Config in the app**. For a subdomain like `go.yourdomain.com`, they follow this shape:

| Type  | Name / Host               | Value                              |
| ----- | ------------------------- | ---------------------------------- |
| TXT   | `_contentgrove-verify.go` | `a657ffc00d52dd8e987fdacfea236ded` |
| CNAME | `go`                      | `cname.contentgrove-dns.com`       |

The TXT record proves you own the domain; the CNAME points the subdomain at contentgrove. Many providers append your root domain automatically, so enter just the **Name** shown (for example `go`), not the full `go.yourdomain.com`.

<Tip>
  Always use a subdomain like `go.yourdomain.com` rather than your root domain. This keeps your main website untouched and lets the subdomain point at contentgrove with a simple CNAME record.
</Tip>

## Use your domain on links

Once your domain is verified, select it as the **domain** when generating links in [Create links](/links/create-links#short-link-builder) or when creating a [dynamic link](/links/dynamic-links) template.

<Note>
  DNS changes can take time to propagate. If verification doesn't succeed right away, wait a little and try again.
</Note>

Need help setting it up? Contact [support@contentgrove.io](mailto:support@contentgrove.io).


# Create dynamic links for every video
Source: https://help.contentgrove.io/links/dynamic-links

Create contentgrove dynamic links that reuse one variable across many videos, with each video automatically getting its own unique tracking link.

Dynamic links let you put the same placeholder in many video descriptions and have each video get its own unique tracking link. A **dynamic link** is a reusable rule you set up once — a variable plus a destination. Add its variable to your descriptions, then run **Process Variables**, and contentgrove replaces it in each video with that video's own unique tracking link.

<Frame>
  <iframe title="How dynamic links help you track your videos" />
</Frame>

## How they work

<Steps>
  <Step title="Create a dynamic link">
    Define a variable name like `{{workshop-link}}` and a destination URL.
  </Step>

  <Step title="Add the variable to descriptions">
    Put `{{workshop-link}}` anywhere in your video descriptions.

    <Frame>
      <img alt="A dynamic link variable placed in a YouTube video description" />
    </Frame>
  </Step>

  <Step title="Process variables">
    On the **Dynamic links** tab, click **Process Variables**. Each video's variable is replaced with its own unique tracking link.
  </Step>
</Steps>

## Create a dynamic link

<Steps>
  <Step title="Open the dialog">
    On the **Dynamic links** tab, click **Create Dynamic Link**.
  </Step>

  <Step title="Fill in the details">
    Set:

    * **Name** — a descriptive label, such as "Free workshop".
    * **Destination URL** — where the link sends traffic.
    * **Variable name** — wrapped in double curly braces, such as `{{workshop-link}}`. Use hyphens or underscores instead of spaces.
    * **Link type** — Offer (select an offer for conversion tracking) or Affiliate.
    * **Domain** — which domain the generated short links use.
  </Step>

  <Step title="Save">
    Click **Create Dynamic Link**.
  </Step>
</Steps>

<Note>
  Variable names are case-insensitive, so `{{Workshop-Link}}` matches `{{workshop-link}}`. Each variable name must be unique across your dynamic links.
</Note>

## Manage dynamic links

Each dynamic link appears as a card showing the name, variable, destination, type, how many videos use it, and the created date. You can:

* **Edit** a dynamic link to change its name, variable, destination, type, offer, or domain.
* **Copy** the variable to paste into your descriptions.
* **Delete** a dynamic link you no longer need.

<Warning>
  Deleting a dynamic link doesn't remove tracking links already generated from it, but you won't be able to process its variable again. If you rename a variable, update any descriptions that still use the old name.
</Warning>

## When to use it

Dynamic links are best when you have one link you use again and again across many videos — your free workshop, your main course or product page, your newsletter, or an affiliate link. Instead of creating a tracking link and pasting it into each video description by hand, you add a single variable, and contentgrove generates a unique tracking link for every video automatically — including new videos you publish later.

## If variables aren't replacing

Check that the variable spelling and `{{ }}` formatting match the dynamic link's variable name, that you've run **Process Variables** on the Dynamic links tab, and that the dynamic link still exists. After processing, use **Verify links in descriptions** in Create links to confirm the replacements.


# Set up offers to track conversions
Source: https://help.contentgrove.io/links/offers

Set up offers in contentgrove by defining landing and thank-you page URLs, so it can measure the conversions and revenue your videos drive.

An offer tells contentgrove which pages on your site are landing pages and which represent a successful conversion. Without an offer, contentgrove can track clicks but not conversions.

<Frame>
  <iframe title="How to create an offer in contentgrove" />
</Frame>

## Create an offer

<Steps>
  <Step title="Open offers">
    Go to the **Offers** page and click **Create offer**.
  </Step>

  <Step title="Name the offer">
    Give it a memorable name, such as "Free course download". This is how it appears in your analytics and link settings.
  </Step>

  <Step title="Set a value (optional)">
    Enter the **Offer Value** — the revenue you earn each time this offer converts — and contentgrove attributes that amount to every conversion, so you can see revenue by video. Leave it blank for conversions with no direct dollar value, such as a newsletter signup or a free download. Those still count as conversions; their value simply shows as **Untracked**.
  </Step>

  <Step title="Set your landing page">
    Enter the landing page URL (where you send viewers) and choose how it should match. For landing pages, **Starts with** is usually best because it still matches when tracking parameters are appended. See [how clicks and conversions are counted](/concepts/clicks-and-conversions#how-contentgrove-matches-your-pages).
  </Step>

  <Step title="Set your thank-you page">
    Enter the thank-you page URL (where visitors land after converting) and choose its match type. **Includes** is flexible; **Starts with** is more specific.
  </Step>

  <Step title="Save">
    Click **Create**.
  </Step>
</Steps>

<Frame>
  <img alt="The create offer dialog in contentgrove with title, value, landing page, and thank-you page fields" />
</Frame>

<Tip>
  Example: for a free ebook, your landing page is where visitors sign up, and your thank-you page is where they get the download. A conversion is counted when a visitor who clicked a tracked link reaches the thank-you page.
</Tip>

## Use offers with links

When you generate a tracking link, choose **Offer link** and select the offer to enable conversion tracking. **Affiliate links** track clicks only, without an offer. See [Create links](/links/create-links#link-type).

<Note>
  You can create a new offer directly from the offer dropdown while generating a link, so you don't have to switch pages.
</Note>

## Multi-step funnels

Some funnels have an intermediate step before the real sale — visitors book a call, register for a webinar, or fill out an application, and only buy later (often on the call itself). contentgrove counts a conversion the moment a tracked visitor reaches an offer's thank-you page, and it doesn't chain funnel steps together automatically. You can still represent a multi-step funnel well by choosing which step your offer measures.

<Steps>
  <Step title="Pick the step that matters most">
    Decide which single action is the conversion you want to attribute to your videos. For call, webinar, or application funnels, this is usually the **booking or registration confirmation** — it's the last online step you can reliably measure, and it tells you which videos drive booked calls and leads.
  </Step>

  <Step title="Point the thank-you page at that step">
    Set the offer's thank-you page to that step's confirmation page — for example, the "You're booked" or "Thanks for registering" page. A conversion is counted when a tracked visitor reaches it.
  </Step>

  <Step title="Choose how to value it">
    Leave the **Offer Value** blank to simply count bookings (they show as **Untracked**), or enter an **expected value per booking** — your average sale price multiplied by the share of bookings that go on to buy — for a modeled revenue view.
  </Step>
</Steps>

<Tip>
  If the final purchase has its own online confirmation or receipt page, you can instead set that as the thank-you page and use the real price as the offer value, so you measure closed revenue rather than bookings.
</Tip>

<Note>
  To watch two steps at once, create a separate offer and tracking link for each and use them on the matching calls to action. contentgrove measures the two offers independently — it won't automatically link a later sale back to the same visitor's earlier booking click.
</Note>


# Install contentgrove tracking on GoHighLevel
Source: https://help.contentgrove.io/tracking/gohighlevel

Add the contentgrove tracking script to your GoHighLevel (GHL) funnels and sites using the footer tracking code setting, so conversions are recorded.

GoHighLevel (GHL) lets you add tracking code to your funnels. You'll paste the contentgrove snippet into the funnel's footer tracking section.

## Add the tracking code

<Steps>
  <Step title="Open tracking code">
    In your GHL funnel, find **Tracking Code** in the upper-left area.

    <Frame>
      <img alt="The Tracking Code option in a GoHighLevel funnel" />
    </Frame>
  </Step>

  <Step title="Copy your snippet">
    In contentgrove, open **Settings → Tracking** and copy the **ClickFunnels** tracking snippet (GHL uses the same snippet). See [Install the tracking script](/tracking/install-script).

    <Frame>
      <img alt="Copying the ClickFunnels tracking snippet from contentgrove settings" />
    </Frame>
  </Step>

  <Step title="Paste into Footer Tracking">
    Paste the snippet into the **Footer Tracking** section and save.

    <Frame>
      <img alt="Pasting the snippet into the Footer Tracking section in GoHighLevel" />
    </Frame>
  </Step>

  <Step title="Publish">
    Save your page and click **Publish** to activate tracking.

    <Frame>
      <img alt="Publishing the GoHighLevel page to activate tracking" />
    </Frame>
  </Step>
</Steps>

<Note>
  Add the snippet to both the landing page and the thank-you page steps of your funnel so clicks and conversions are both recorded.
</Note>

Once published, the snippet starts tracking interactions and conversions across your funnel. If tracking isn't recording, see [Tracking isn't recording clicks](/troubleshooting/tracking-not-recording).


# Install tracking with Google Tag Manager
Source: https://help.contentgrove.io/tracking/google-tag-manager

Install the contentgrove tracking script as a Custom HTML tag in Google Tag Manager, so it fires on any platform connected to your GTM container.

Google Tag Manager (GTM) lets you deploy the tracking script across any site that has GTM installed, without touching your site's code. You'll add the contentgrove snippet as a Custom HTML tag.

## Prerequisites

You need a GTM account and a container installed on your site. If you don't have one yet, create it at [tagmanager.google.com](https://tagmanager.google.com).

## Add the tag

<Steps>
  <Step title="Create a new tag">
    In your GTM container, go to **Tags** and click **New**. Name it something like "contentgrove Tracker", then open **Tag Configuration**.

    <Frame>
      <img alt="Creating a new tag in the Tags section of Google Tag Manager" />
    </Frame>

    <Frame>
      <img alt="Naming the tag and opening Tag Configuration in Google Tag Manager" />
    </Frame>
  </Step>

  <Step title="Choose Custom HTML">
    Set the tag type to **Custom HTML**.

    <Frame>
      <img alt="Selecting Custom HTML as the tag type in Google Tag Manager" />
    </Frame>
  </Step>

  <Step title="Paste the snippet">
    Copy your GTM snippet from **Settings → Tracking** in contentgrove and paste it into the HTML field. See [Install the tracking script](/tracking/install-script#choose-an-installation-method) for the snippet format.

    <Frame>
      <img alt="Pasting the contentgrove snippet into the Custom HTML field" />
    </Frame>
  </Step>

  <Step title="Set the trigger">
    Click **Triggering** and add a trigger of type **Page View – DOM Ready**. If you don't have one yet, click the plus icon to create it, name it, and save.

    <Frame>
      <img alt="Opening Triggering to add a trigger in Google Tag Manager" />
    </Frame>

    <Frame>
      <img alt="Creating a new trigger with the plus icon in Google Tag Manager" />
    </Frame>

    <Frame>
      <img alt="Selecting Page View – DOM Ready as the trigger type" />
    </Frame>

    <Frame>
      <img alt="The completed contentgrove tag with its Custom HTML and DOM Ready trigger" />
    </Frame>
  </Step>

  <Step title="Submit and publish">
    Click **Submit**, then **Publish**. Without publishing, the tag won't be active.

    <Frame>
      <img alt="Clicking Submit to publish the container in Google Tag Manager" />
    </Frame>

    <Frame>
      <img alt="Confirming the publish in Google Tag Manager" />
    </Frame>

    <Frame>
      <img alt="The published contentgrove GTM tag, ready to track" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Use the **DOM Ready** trigger, not "Container Loaded". The wrong trigger is the most common reason GTM tracking doesn't fire.
</Warning>

## Verify it works

In contentgrove, open **Settings → Tracking** and use the **Verify tracker** tool. You can also use GTM's preview mode to confirm the tag fires on your pages.

Once configured, you can deploy the same tag on any platform that supports GTM by adding your container ID (format `GTM-XXXXXXX`). If tracking isn't recording, see [Tracking isn't recording clicks](/troubleshooting/tracking-not-recording).


# Install the tracking script
Source: https://help.contentgrove.io/tracking/install-script

Install the contentgrove tracking script using a script tag, Google Tag Manager, or window config, and confirm it's firing on your landing pages.

The tracking script records clicks and conversions on your site. Add it to your landing pages and your thank-you pages. It loads asynchronously, so it won't slow down your pages.

## Find your platform

If you use one of these platforms, follow its step-by-step guide — it's the fastest path:

<Columns>
  <Card title="WordPress" icon="wordpress" href="/tracking/wordpress">
    Install the official contentgrove plugin — no code needed.
  </Card>

  <Card title="Google Tag Manager" icon="google" href="/tracking/google-tag-manager">
    Deploy the script as a Custom HTML tag across any GTM site.
  </Card>

  <Card title="Kit (ConvertKit)" icon="envelope" href="/tracking/kit">
    Track Kit landing pages through its GTM integration.
  </Card>

  <Card title="GoHighLevel" icon="filter" href="/tracking/gohighlevel">
    Paste the snippet into your funnel's footer tracking.
  </Card>

  <Card title="Any other platform" icon="code" href="#choose-an-installation-method">
    Paste the universal snippet anywhere you can add custom HTML.
  </Card>
</Columns>

Don't see your platform? contentgrove works anywhere you can add custom HTML or a script — use the universal snippet below. See [all supported platforms](/tracking/supported-platforms) to check yours.

## Get your tracking snippet

<Steps>
  <Step title="Open tracking settings">
    In contentgrove, go to **Settings → Tracking**.
  </Step>

  <Step title="Choose your platform">
    Choose the platform you are using.
  </Step>
</Steps>

<Frame>
  <img alt="The tracking settings page in contentgrove with website provider options" />
</Frame>

## Choose an installation method

<Tabs>
  <Tab title="Script tag">
    The simplest option. Paste this just before the closing `</body>` tag on every page you want to track, and replace `YOUR_TRACKING_ID` with your own:

    ```html theme={null}
    <script
      src="https://cdn.contentgrove.workers.dev/cg-tracker.js"
      data-tracking-id="YOUR_TRACKING_ID"
      async
    ></script>
    ```
  </Tab>

  <Tab title="Google Tag Manager">
    Create a **Custom HTML** tag with this code, replacing `YOUR_TRACKING_ID`:

    ```html theme={null}
    <script>
      window.contentgroveConfig = {
        trackingId: "YOUR_TRACKING_ID",
      };
    </script>
    <script src="https://cdn.contentgrove.workers.dev/cg-tracker.js" async></script>
    ```

    Set the trigger to **Page View – DOM Ready** (not "Container Loaded"), then save and publish. For the full walkthrough, see [Google Tag Manager](/tracking/google-tag-manager).
  </Tab>

  <Tab title="Window config">
    Set the config in a script block that runs before the tracker loads:

    ```html theme={null}
    <script>
      window.contentgroveConfig = {
        trackingId: "YOUR_TRACKING_ID",
      };
    </script>
    <script src="https://cdn.contentgrove.workers.dev/cg-tracker.js" async></script>
    ```

    Make sure the config block loads before the tracking script.
  </Tab>
</Tabs>

<Tip>
  Place the script in your footer (just before `</body>`) for the best page speed. Add it to both your landing pages and your thank-you pages, or tracking will miss conversions.
</Tip>

## Verify your installation

In **Settings → Tracking**, use the **Verify tracker** tool. Enter your website URL and run the check to confirm the script is loading.

<Frame>
  <img alt="The Verify tracker tool in contentgrove confirming the script is installed" />
</Frame>

You can also verify manually: open your site, press <kbd>F12</kbd>, open the **Network** tab, and look for `cg-tracker.js`.

## GDPR and consent

By default, the script tracks as soon as it loads. If you need tracking to wait for visitor consent, add `data-require-consent="true"` to the script tag (or `requireConsent: true` in the window config) to turn on strict consent mode. In that mode the script only tracks after the visitor grants consent through a supported consent platform — Cookiebot, CookieYes, CookieScript, OneTrust, or the WordPress Consent API — and stays blocked if none is present. See [How tracking works](/concepts/how-tracking-works#consent-mode) for the full behavior.

If you declare cookies in your consent platform, use these details:

| Field              | Value                                                |
| ------------------ | ---------------------------------------------------- |
| Cookie name        | `contentgrove_click_id`                              |
| Script URL pattern | `*cg-tracker.js*`                                    |
| Category           | Analytics / Statistics                               |
| Duration           | 30 days                                              |
| Purpose            | Stores a click ID to link conversions back to clicks |

## Good to know

* **Use it on multiple sites.** The same Tracking ID works across all your websites; data lands in that workspace's dashboard.
* **Blocked cookies.** If cookies are blocked, the script falls back to session storage, so tracking still works for that browser session.
* **HTTPS.** Serve your pages over HTTPS for reliable cookie storage.

If tracking isn't recording, see [Tracking isn't recording clicks](/troubleshooting/tracking-not-recording).


# Install contentgrove tracking in Kit (ConvertKit)
Source: https://help.contentgrove.io/tracking/kit

Track contentgrove clicks and conversions on your Kit (ConvertKit) landing pages by adding the tracking script through the Google Tag Manager integration.

Kit (formerly ConvertKit) doesn't accept a raw script tag on landing pages, so contentgrove tracks Kit pages through Kit's built-in Google Tag Manager integration.

## Prerequisites

Set up Google Tag Manager first, with the contentgrove tag installed in your container. See [Set up tracking in Google Tag Manager](/tracking/google-tag-manager). You'll need your GTM container ID (format `GTM-XXXXXXX`).

## Add your GTM tag to a landing page

<Steps>
  <Step title="Open your landing page">
    In Kit, open the landing page you want to track.

    <Frame>
      <img alt="Opening a landing page in Kit" />
    </Frame>
  </Step>

  <Step title="Open settings">
    Open the landing page's **Settings**.

    <Frame>
      <img alt="Opening the settings for a Kit landing page" />
    </Frame>
  </Step>

  <Step title="Go to SEO & Analytics">
    Select the **SEO & Analytics** tab.

    <Frame>
      <img alt="The SEO & Analytics tab in Kit landing page settings" />
    </Frame>
  </Step>

  <Step title="Enter your GTM ID">
    In the Google Tag Manager field, paste your container ID (`GTM-XXXXXXX`).

    <Frame>
      <img alt="Entering the Google Tag Manager container ID in Kit" />
    </Frame>

    <Frame>
      <img alt="The Google Tag Manager field in Kit's SEO & Analytics settings" />
    </Frame>
  </Step>

  <Step title="Save and publish">
    Click **Save & Publish**.

    <Frame>
      <img alt="Saving and publishing the Kit landing page" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Kit sometimes adds a leading space when you paste your GTM ID. Remove any space before the `GTM-` prefix before saving, or the integration won't work.
</Warning>

<Note>
  You have to add the GTM ID to every Kit landing page you want to track, including both your landing pages and your thank-you pages.
</Note>


# Platforms contentgrove tracking supports
Source: https://help.contentgrove.io/tracking/supported-platforms

See which website, landing page, course, and email platforms work with contentgrove tracking, and the ways to install the script on almost any platform.

contentgrove tracking works with virtually any website, landing page, or course platform that lets you add custom HTML, a JavaScript snippet, or a Google Tag Manager container.

## Website builders & online stores

* WordPress (including WooCommerce)
* Wix
* Squarespace
* Shopify
* BigCommerce
* Webflow
* Framer
* Ghost
* Duda
* Weebly
* GoDaddy Website Builder

## Landing page & funnel builders

* ClickFunnels
* GoHighLevel (GHL)
* Systeme.io
* Unbounce
* Leadpages
* Instapage
* Carrd

## Course & membership platforms

* Kajabi
* Teachable
* Thinkific

## Email & CRM platforms

* Kit (ConvertKit)
* MailerLite
* HubSpot

## How to install

There are three ways to add the script — a direct script tag, Google Tag Manager, or a page-builder code block — and most platforms support at least one. The snippet and all three methods are covered on one page: [Install the tracking script](/tracking/install-script).

For **WordPress**, **Google Tag Manager**, **Kit**, and **GoHighLevel**, there's a dedicated step-by-step [platform guide](/tracking/install-script#find-your-platform).

<Tip>
  If your platform lets you add header or footer code, a custom HTML block, Google Tag Manager, or third-party scripts, contentgrove will work.
</Tip>

Don't see your platform? As long as it supports custom HTML or GTM, you can still use contentgrove. Reach out to [support@contentgrove.io](mailto:support@contentgrove.io) if you're unsure.


# Install contentgrove tracking on WordPress
Source: https://help.contentgrove.io/tracking/wordpress

Add contentgrove tracking to your WordPress site with the official plugin, so clicks and conversions are recorded on every page and stay up to date.

The easiest way to track a WordPress site is the official contentgrove plugin. It keeps the tracking file on your site, lets you manage everything from the WordPress admin, and updates itself from the Plugins screen. If you'd rather not install a plugin, you can add the script manually instead.

## Install the contentgrove plugin

<Steps>
  <Step title="Download the plugin">
    Download the plugin `.zip` — this link always gives you the latest version:

    <Card title="Download the contentgrove WordPress plugin" icon="download" href="https://app.contentgrove.io/api/wordpress-plugin/updates/contentgrove/download">
      The plugin zip, ready to upload to WordPress.
    </Card>
  </Step>

  <Step title="Upload it to WordPress">
    In your WordPress dashboard, go to **Plugins → Add Plugin → Upload Plugin**, select the `.zip` file, and install and activate it.
  </Step>

  <Step title="Open the plugin settings">
    Go to **Settings → contentgrove** in your WordPress admin.
  </Step>

  <Step title="Connect to contentgrove">
    Click **Connect to contentgrove**. This opens contentgrove to link the plugin to your account.
  </Step>

  <Step title="Approve the site">
    In contentgrove, choose the active workspace that should receive tracking from this site, then approve the connection. You need workspace admin or owner access.
  </Step>

  <Step title="Choose what to track">
    Leave **Entire site** selected so the script runs on every page, including your landing and thank-you pages. Only narrow this if you want to track specific pages or posts.
  </Step>
</Steps>

<Note>
  The site stays bound to the workspace you choose. To send tracking to another workspace, disconnect the site in **Settings → contentgrove**, then reconnect it and choose the new workspace. The plugin updates itself from the **Plugins** screen when a new version is released.
</Note>

## Updating an existing installation

Version 1.1 and later automatically confirm the workspace already attached to your installation. Tracking pauses briefly until that check succeeds, so data cannot accidentally be sent to another workspace. If WordPress shows a workspace synchronization warning, use **Retry workspace sync**. If the connection can no longer be verified, disconnect and reconnect the site.

## Alternative: add the script manually

If you prefer not to install a plugin, add the tracking script site-wide with the free WPCode plugin, which lets you insert code without editing your theme.

<Steps>
  <Step title="Open plugin installation">
    In your WordPress dashboard, go to **Plugins → Add Plugin**.
  </Step>

  <Step title="Install WPCode">
    Search for "code snippet", then install and activate **WPCode**.

    <Frame>
      <img alt="Installing the WPCode plugin from the WordPress plugin directory" />
    </Frame>
  </Step>

  <Step title="Add a new snippet">
    Open WPCode and choose **+ Add Snippet**, then **Add Your Custom Snippet**.

    <Frame>
      <img alt="The Add Snippet button in WPCode" />
    </Frame>

    <Frame>
      <img alt="Choosing Add Your Custom Snippet in WPCode" />
    </Frame>
  </Step>

  <Step title="Choose HTML snippet">
    Select **HTML Snippet** as the type.

    <Frame>
      <img alt="Selecting HTML Snippet as the code type in WPCode" />
    </Frame>
  </Step>

  <Step title="Paste your tracking code">
    Give the snippet a title, then paste your HTML tracking code from **Settings → Tracking** in contentgrove. See [Install the tracking script](/tracking/install-script) for the code.

    <Frame>
      <img alt="Naming the snippet and pasting the contentgrove tracking code in WPCode" />
    </Frame>

    <Frame>
      <img alt="The contentgrove tracking code pasted into the WPCode editor" />
    </Frame>
  </Step>

  <Step title="Set the location">
    Set the location to **Site Wide Footer**.

    <Frame>
      <img alt="Setting the WPCode snippet location to Site Wide Footer" />
    </Frame>
  </Step>

  <Step title="Activate and save">
    Toggle the snippet on and click **Save Snippet**.

    <Frame>
      <img alt="Activating the snippet and clicking Save Snippet in WPCode" />
    </Frame>
  </Step>
</Steps>

## Verify it works

In contentgrove, open **Settings → Tracking**, use the **Verify tracker** tool, enter your website URL, and run the check.

<Frame>
  <img alt="Verifying the tracking installation from contentgrove settings" />
</Frame>

If tracking isn't recording, see [Tracking isn't recording clicks](/troubleshooting/tracking-not-recording).


# Contact contentgrove support
Source: https://help.contentgrove.io/troubleshooting/contact

How to reach contentgrove support: send a message from the in-app help widget, or email support@contentgrove.io, and what to include so we can help fast.

Need a hand? There are two ways to reach us — the in-app help widget is the fastest, and email works for everything else.

<Info>
  If contentgrove isn't loading or data appears delayed, check the [contentgrove status page](https://status.contentgrove.io) for an active incident before contacting support.
</Info>

## Message us in the app

When you're signed in to contentgrove, the quickest way to reach us is the help widget.

<Steps>
  <Step title="Open the help widget">
    Click the help icon in the bottom-right corner of the app.
  </Step>

  <Step title="Start a message">
    Choose to send us a message or ask a question.
  </Step>

  <Step title="Send it">
    Describe what's going on and send. Replies come to your email, so you don't have to keep the app open.
  </Step>
</Steps>

<Tip>
  Sending from inside the app is best because you're already signed in — we can see which account you're writing from, so there's less back-and-forth.
</Tip>

## Email us

You can also reach us any time at [support@contentgrove.io](mailto:support@contentgrove.io). To help us answer on the first reply, send from the email address on your account and include:

* Your **workspace name**.
* The **link, video, or URL** involved, if it's about something specific.
* A short description of what you expected and what happened instead.

## When to expect a reply

We read every message and reply by email, usually within one business day. More involved issues can take a little longer, and we'll keep you posted while we look into it.

## Check these first

Many questions have a quick answer in the docs. If something isn't working, these pages often solve it faster than waiting on a reply:

<Columns>
  <Card title="Tracking isn't recording" icon="signal" href="/troubleshooting/tracking-not-recording">
    Clicks or page views not showing up.
  </Card>

  <Card title="A video isn't showing" icon="video" href="/troubleshooting/video-not-showing">
    A video is missing or its numbers look off.
  </Card>

  <Card title="Conversions not attributed" icon="circle-check" href="/troubleshooting/conversions-not-attributed">
    Conversions aren't tied back to your videos.
  </Card>
</Columns>


# Conversions aren't being attributed
Source: https://help.contentgrove.io/troubleshooting/conversions-not-attributed

Why contentgrove records clicks but conversions don't show up: the tracking script, thank-you page matching, consent, and the 30-day attribution window.

If clicks appear but conversions don't, the issue is on the tracking-script side: the script isn't firing on your pages, the thank-you page doesn't match your offer, or the attribution window passed. Unlike clicks, conversions rely on the script running on both your landing and thank-you pages.

## Quick checks

<Steps>
  <Step title="Confirm a click was tracked first">
    Conversions only count when the visitor previously clicked a tracked link. If the click wasn't recorded, fix that first — see [Tracking isn't recording clicks](/troubleshooting/tracking-not-recording).
  </Step>

  <Step title="Confirm the script is loading">
    The tracking script must load on **both** your landing page and your thank-you page. The landing page stores the click ID; the thank-you page records the conversion. Open each page, press <kbd>F12</kbd>, go to the **Network** tab, and look for `cg-tracker.js`. If it's missing, the script isn't installed on that page. See [Install the tracking script](/tracking/install-script).
  </Step>

  <Step title="Verify your Tracking ID">
    Make sure the `data-tracking-id` (or `contentgroveConfig.trackingId`) matches the Tracking ID in **Settings → Tracking**. A wrong or placeholder value (`YOUR_TRACKING_ID`) stops tracking.
  </Step>

  <Step title="Check the thank-you URL matches your offer">
    The thank-you page URL must match the pattern and [match type](/concepts/clicks-and-conversions#how-contentgrove-matches-your-pages) on your offer. "Includes" is flexible; an overly strict "Exact match" is a common cause.
  </Step>

  <Step title="Check the 30-day window">
    A conversion is attributed only if it happens within 30 days of the click, in the same browser. Conversions outside that window, or in a different browser, can't be linked.
  </Step>

  <Step title="Check consent and subscription">
    If you use a consent management platform, the script only runs after the visitor grants consent. In strict consent mode (`data-require-consent="true"`), tracking stays blocked until consent is given. Tracking also requires an active subscription. See [GDPR and consent](/tracking/install-script#gdpr-and-consent).
  </Step>
</Steps>

## Console messages

Open the **Console** tab in your browser's developer tools and look for messages:

| Message                                                                                                   | Meaning                                                                                                                                                    |
| --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `contentgrove: tracker configuration not found.`                                                          | The script loaded but no Tracking ID was set. Check `data-tracking-id` (or `contentgroveConfig.trackingId`) is present and not left as `YOUR_TRACKING_ID`. |
| `Tracking blocked until marketing consent is granted.`                                                    | The visitor hasn't granted consent yet in your CMP. Tracking runs once they accept.                                                                        |
| `Tracking blocked because strict consent mode is enabled and no supported consent provider was detected.` | `data-require-consent` is on, but no supported consent platform was found on the page.                                                                     |
| `[contentgrove] ❌ Click tracking error`                                                                   | The tracking request failed (network or server). Retry, and check the script can reach contentgrove.                                                       |

## Google Tag Manager

If you installed via GTM, the most common cause is the wrong trigger. Use **Page View – DOM Ready**, not "Container Loaded", make sure the config loads first, and confirm you clicked **Submit** and **Publish**. See [Set up tracking in Google Tag Manager](/tracking/google-tag-manager).

## Test the full flow

Click one of your tracking links, complete your form or purchase, reach the thank-you page, and check your dashboard. Testing in an incognito window helps confirm the click ID is set and read correctly.

<Note>
  Refreshing the thank-you page won't add extra conversions — each click counts at most once. Manual conversions you add yourself are separate and aren't auto-attributed.
</Note>

## Still not attributing?

Contact [support@contentgrove.io](mailto:support@contentgrove.io) with your offer's landing and thank-you patterns and the URLs you're testing.


# System status
Source: https://help.contentgrove.io/troubleshooting/system-status

View current availability and recent incidents for contentgrove websites, application services, tracking, integrations, and YouTube data sync.



# Tracking isn't recording clicks
Source: https://help.contentgrove.io/troubleshooting/tracking-not-recording

Why clicks may not appear in contentgrove analytics. Clicks are recorded at the short-link redirect, so most fixes come down to the link, not the script.

If clicks aren't appearing in your analytics, the cause is usually the link itself or where you're looking — not the tracking script.

<Note>
  Clicks are recorded server-side at the short-link redirect, the moment someone clicks your link. The tracking script on your pages is **not** involved in counting clicks — it only links a click to a later conversion. If clicks record but conversions don't, see [Conversions aren't being attributed](/troubleshooting/conversions-not-attributed).
</Note>

## Quick checks

<Steps>
  <Step title="Confirm you're sharing a contentgrove short link">
    The click is only recorded if visitors go through your contentgrove short link (like `grve.to/free-course` or your custom domain), not the raw destination URL. If you pasted the plain link into your video, no click is recorded.
  </Step>

  <Step title="Check the link is active">
    A paused or deleted link sends visitors to a "link not found" page and records nothing. Confirm the link is still active on the [All links](/links/all-links) page.
  </Step>

  <Step title="Check your subscription">
    Tracking runs only while your subscription is active. Confirm in [Settings → Billing](/account/billing-and-plans).
  </Step>

  <Step title="Rule out test-click filtering">
    Clicks made immediately after creating a link may be filtered as bot traffic, and known bots are always excluded. If you're testing your own link, wait a moment before clicking, and check that your analytics date range covers when you clicked.
  </Step>
</Steps>

## Still not working?

Test in an incognito window to rule out cached state, then contact [support@contentgrove.io](mailto:support@contentgrove.io) with the short link you're testing.


# A video isn't showing up
Source: https://help.contentgrove.io/troubleshooting/video-not-showing

Why a video might be missing from contentgrove or showing incomplete metrics, including YouTube's sync delay, and how to refresh your data.

If a video is missing or its numbers look off, it's usually a sync or reporting-delay issue rather than a tracking problem.

## A video is missing

<Steps>
  <Step title="Refresh your videos">
    In the [Create links](/links/create-links#bulk-actions) tab, run **Refresh video descriptions** to re-sync titles, thumbnails, and metadata from YouTube. New uploads appear after a sync.
  </Step>

  <Step title="Confirm the channel">
    Make sure the video belongs to the YouTube channel you connected. If you manage several channels, the video may be on a different one. See [Connect your YouTube account](/getting-started/connect-youtube).
  </Step>

  <Step title="Check the video's status">
    Private or deleted videos behave differently from public ones. A deleted video may still appear with historical data but won't gain new metrics.
  </Step>
</Steps>

## Metrics look low or incomplete

YouTube's reporting pipeline can lag by up to **72 hours**. Views, watch time, subscribers, and anything derived from them for the most recent few days may be incomplete and rise later as YouTube finalizes its data.

<Note>
  Clicks, conversions, and revenue come from contentgrove's own tracking and are not affected by YouTube's delay. If those look wrong, see [Tracking isn't recording clicks](/troubleshooting/tracking-not-recording).
</Note>

## Still missing?

If a public video on the connected channel still doesn't appear after a refresh, contact [support@contentgrove.io](mailto:support@contentgrove.io) with the video URL.


# What is contentgrove
Source: https://help.contentgrove.io/welcome/what-is-contentgrove

Learn what contentgrove is: it connects your YouTube video performance to the clicks, conversions, and revenue each of your videos actually drives.

contentgrove connects your YouTube video performance to the clicks, conversions, and revenue those videos drive. Instead of optimizing for views and guessing what's working, you see which videos send people to your offers and which of those turn into customers — your real income, video by video.

<Frame>
  <iframe title="Introduction to contentgrove" />
</Frame>

## What you can do with contentgrove

* **Track every link** — create short tracking links for your videos on your own domain and see the clicks each one earns. See [Generate Tracking Links](/links/create-links).
* **Connect clicks to revenue** — define [offers](/links/offers) so contentgrove credits conversions and revenue back to the video that drove them.
* **See revenue per video** — a creator-focused [dashboard](/analytics/overview) that shows which videos make money, not just which get views.
* **Generate links at scale** — [dynamic links](/links/dynamic-links) and the [browser extension](/links/browser-extension) create and insert tracking links across all your videos.
* **Ask in plain language** — connect contentgrove to Claude or ChatGPT through the [MCP](/ai-mcp/introduction) and ask about your analytics directly.

## Why contentgrove exists

YouTube Studio shows you views, watch time, and click-through rate — the numbers YouTube optimizes for. None of them tell you which videos actually make you money. That answer is usually split across YouTube, a separate analytics tool, and your affiliate dashboards, so most creators never see it.

contentgrove brings the whole path into one place — view to click to conversion to revenue — so you can do more of what earns and stop pouring time into videos that get views but no income.

## Where to go next

<Columns>
  <Card title="Who contentgrove is for" icon="users" href="/welcome/who-its-for">
    See whether contentgrove fits how you work.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/getting-started/quickstart">
    Set up tracking in about five minutes.
  </Card>

  <Card title="How tracking works" icon="route" href="/concepts/how-tracking-works">
    The click-to-conversion flow, explained.
  </Card>

  <Card title="Analytics" icon="chart-line" href="/analytics/overview">
    Read your dashboard and understand each metric.
  </Card>
</Columns>


# Who contentgrove is for
Source: https://help.contentgrove.io/welcome/who-its-for

See who contentgrove is for: YouTube creators monetizing their own channel, and the consultants and agencies who manage and grow those channels.

contentgrove is built for anyone who makes money from YouTube and wants to know which videos actually drive it. Two groups get the most out of it: creators monetizing their own channel, and the consultants and agencies who manage or advise those channels. Find your situation below.

## Creators monetizing their channel

You run your own channel and earn through affiliate links, digital products, courses, coaching, memberships, or brand deals. You're past relying on AdSense alone, and you want to grow income instead of just view count. This covers solo creators, creator-entrepreneurs selling their own products, and affiliate marketers promoting other people's.

**Typical goals**

* See which of your videos actually make money, so you can make more of what works.
* Track every affiliate and offer link in one place instead of across separate dashboards.
* Find the two or three videos quietly driving most of your income — and double down.

**Features to lean on**

* [Tracking Links](/links/create-links) and [dynamic links](/links/dynamic-links) — create tracking links for one video or all of them at once.
* [Offers](/links/offers) and [conversion tracking](/concepts/conversion-tracking) — connect clicks to real sales and revenue.
* [Analytics](/analytics/overview) — revenue per video, top performers, and your full view-to-sale funnel.

<Note>
  New here? Start with the [Quickstart](/getting-started/quickstart), then learn [how tracking works](/concepts/how-tracking-works).
</Note>

## YouTube consultants and agencies

You manage or advise on other people's channels — as a YouTube strategist, a coach, or an agency running creator accounts. Your clients judge your work by results, so you need to show the revenue impact of the content and strategy you deliver, not just that views went up.

**Typical goals**

* Prove the impact of your work in revenue terms, not vanity metrics.
* Set tracking up once for a client and hand them a dashboard they can read at a glance.
* Keep each client's analytics, links, and access fully separate from the others.
* Pull quick, clear performance reports without stitching together three tools.

**Features to lean on**

* [Workspaces](/concepts/organizations-and-workspaces) — give each client their own workspace so their data and team access stay isolated, and switch between them from one login.
* [Install the tracking script](/tracking/install-script) and [Google Tag Manager](/tracking/google-tag-manager) — get a client tracking quickly, even on platforms that block direct script injection.
* [Custom domains](/links/custom-domains) — keep links on the client's own brand.
* [AI assistant & MCP](/ai-mcp/introduction) — ask for a client's numbers in plain language when you're putting a report together.

<Note>
  Managing several clients? Create one workspace per client so each stays separate. See [How organizations and workspaces work](/concepts/organizations-and-workspaces), then [Connect your YouTube account](/getting-started/connect-youtube) and [How tracking works](/concepts/how-tracking-works).
</Note>

## Who contentgrove isn't for

contentgrove is built around links, offers, and conversions. It's probably not the right fit if:

* You monetize only through AdSense, with no links, products, or offers to track.
* You're a large media company that already runs an enterprise analytics stack.
* You're not looking to optimize — you create for fun and don't need revenue insights.

## Not sure if it's a fit?

<Card title="Try the Quickstart" icon="rocket" href="/getting-started/quickstart">
  Set up tracking in about five minutes and see your own revenue-per-video for the first time.
</Card>