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

# Campaigns

> Group related challenges into campaigns with shared metadata and schedule

Campaigns are a way to group related challenges — a summer launch, a Black Friday blitz, a Q4 loyalty push — so they share a timeline and appear together in analytics and calendar views.

## Creating a campaign

From **Engagement -> Campaigns** (or via the Admin API `/campaigns` endpoints):

<Steps>
  <Step title="Name the campaign" icon="pen">
    Give it a clear, recognisable name — this is what admins see in lists and calendar views.
  </Step>

  <Step title="Set date range" icon="calendar">
    Start and end dates (campaign date-picker z-index fixed in #1731 so it plays nice with modals).
  </Step>

  <Step title="Add challenges" icon="trophy">
    Attach existing Live / Scheduled / Draft challenges. A challenge can belong to at most one campaign.
  </Step>

  <Step title="Save" icon="save">
    Campaign goes Live immediately (or Scheduled if start date is future).
  </Step>
</Steps>

***

## Campaigns in the calendar

Campaigns show as coloured backdrops in the [Calendar View](/admin-guide/challenges/calendar-view) — all challenges in the campaign display together, making scheduling conflicts visible at a glance.

***

## Filtering by campaign

The challenge list (#1155) has a **Campaign** filter in the unified filter drawer. Pick a campaign to see only its challenges.

***

## Analytics

Campaign-level analytics show:

* Total participants across all challenges in the campaign
* Completion funnel aggregated across challenges
* Reward distribution summary
* Start-to-finish timeline

Click any challenge in the campaign to drill into individual analytics.

***

## API

* `GET /admin/campaigns` — list
* `POST /admin/campaigns` — create
* `PATCH /admin/campaigns/:id` — update
* `GET /admin/campaigns/:id/challenges` — attached challenges

See [Admin API reference](/api-reference/admin).

***

## When to use campaigns

<Tip>
  Use campaigns for **themed sets** of 3-20 challenges with a shared start/end. Don't use them for organising your content long-term — use [tags](/admin-guide/settings/tags) for that.
</Tip>

<Tip>
  Run **one live campaign at a time** if possible. Overlapping campaigns splinter member attention.
</Tip>