This product is not supported for your selected
Datadog site. (
).
Overview
Datadog Case Management allows customization to align with your team’s unique workflows, data capture needs, and reporting requirements.
Custom Case Types
You must have Case Shared Settings Write (
cases_shared_settings_write
) permissions. For more information, see
Datadog Role Permissions.
Datadog provides five built-in case types, each designed for common workflows. To customize Case Management for your team’s needs, you can define your own custom case types. This allows you to:
- Scope custom data capture to relevant work types
- Enable targeted automation
- Conduct more granular analytics and reporting
Create a custom case type
- Navigate to Settings > Shared Settings > Case Types.
- Click + Create Case Type.
- Provide a Name and an optional Description.
- Save your new case type.
- (Optional) See the custom attributes section of this page to add custom attributes.
Enable a custom case type
After you create a custom case type, you must explicitly assign it to each project where it should be available. Follow the steps below to enable your new case type within a specific Case Management project.
- Back on the Settings page, locate the target project under either Starred Projects or Other Projects.
- Expand the project menu by clicking on the project name.
- Click General to open the project’s settings panel.
- Scroll down to the Case Types section in the settings panel.
- Under From your organization, open the dropdown and select the custom case type you created.
After you add the case type, it is available as an option when you create a new case within that project.
Your new case type is available for:
- Manual case creation
- API-based creation
- Automated case creation through Workflows
Custom attributes
Custom attributes allow you to capture the structured data your team needs to work efficiently and report effectively. All case types, whether Datadog-provided or custom, include five reserved attributes that cannot be removed or modified:
- Teams
- Services
- Environments
- Datacenters
- Versions
You can add attributes that reflect your team’s specific needs, such as escalation levels, component owners, business impact, or external links. To add a custom attribute:
- Navigate to Settings > Shared Settings > Case Types.
- Click the desired case type.
- Click + Add Attribute.
- Provide:
- Display Name (such as “Region”)
- Key (used for programmatic access and reporting)
- Description (optional context for your team)
- Data Type, choose from:
- Choose whether to allow multiple values for this attribute.
Further reading
Additional helpful documentation, links, and articles: