---
title: Campaigns
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Internal Developer Portal > Campaigns
---

# Campaigns

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ().
{% /alert %}

{% /callout %}

{% image
   source="https://docs.dd-static.net/images/tracing/software_catalog/campaign-manage.d399ea57133870ad742f736d95c16882.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/campaign-manage.d399ea57133870ad742f736d95c16882.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="List of Campaigns in Internal Developer Portal" /%}

## Overview{% #overview %}

Campaigns let you coordinate short-term engineering initiatives by grouping [Scorecard](https://docs.datadoghq.com/internal_developer_portal/scorecards.md) rules under a shared goal and tracking adoption across entities and teams.

While Scorecards define long-term best practices, campaigns help you focus efforts on time-bound initiatives such as runtime migrations, security remediations, or cost optimization. You can set a deadline, select rules to track, and monitor completion across teams.

Use the [**Campaigns** tab on the Scorecards page](https://app.datadoghq.com/software/scorecards?activeTab=campaigns) to:

- View active and past campaigns
- Track progress by rule, team, or status
- Follow up with teams directly from the interface

If your service is part of a campaign, related rules and deadlines appear in the entity's **Scorecards** tab in Software Catalog, and on the entity page in the **Scorecards** section. This visibility lets teams act on campaign goals without relying on manual reminders or external documentation.

## Creating a campaign{% #creating-a-campaign %}

Create and manage campaigns from the [**Campaigns** tab in Scorecards](https://app.datadoghq.com/software/scorecards?activeTab=campaigns).

**Note:** Creating a campaign requires the Service Catalog Write and Case Management Write permissions.

{% image
   source="https://docs.dd-static.net/images/tracing/software_catalog/campaign-creation.28b457ac783b339abb288d5e36b37b9f.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/campaign-creation.28b457ac783b339abb288d5e36b37b9f.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Campaign creation page with fields filled out" /%}

### 1. Define campaign metadata

Provide the following information:

- **Name**: A short, descriptive title (for example, "Migrate to GitHub Actions")
- **Key**: A unique identifier for the campaign (auto-generated by default)
- **Description**: A short summary of the campaign's goal
- **Owner**: The team responsible for driving the campaign
- **Start and end date**: The campaign timeline (end date is optional)
- **Scope**: Entities the campaign applies to (for example, `kind:service AND tier:1`)

### 2. Select Scorecard rules

Add one or more [existing Scorecard rules](https://docs.datadoghq.com/internal_developer_portal/scorecards/custom_rules.md#create-custom-rules) that align with your campaign's goal.

### 3. Define guidance

For each rule, optionally include:

- Linked documentation
- Workflows through [Workflow Automation](https://docs.datadoghq.com/actions/workflows.md) to automatically remediate failing rules
- Steps teams should follow to meet compliance

## Tracking campaign progress{% #tracking-campaign-progress %}

After creating a campaign, use the campaign page to monitor adoption and follow up as needed.

{% image
   source="https://docs.dd-static.net/images/tracing/software_catalog/campaign-details.bff34ed31ed83e498a73638f4221d206.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/tracing/software_catalog/campaign-details.bff34ed31ed83e498a73638f4221d206.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Campaign page highlighting campaign details, progress, and next steps" /%}

From the campaign page, you can:

- See overall completion and progress by team or rule
- Filter to find entities, teams, or rules that are still failing
- Compare adoption rates across teams
- View progress trends over time
- Send updates or create follow-up tickets directly from the page

## Further reading{% #further-reading %}

- [Scorecards Documentation](https://docs.datadoghq.com/internal_developer_portal/scorecards.md)
- [Coordinate large-scale engineering initiatives with IDP Campaigns](https://www.datadoghq.com/blog/idp-campaigns/)