---
title: Powerpack Widget
description: >-
  Create reusable widget groups to standardize dashboard layouts and scale
  monitoring expertise across teams.
breadcrumbs: Docs > Dashboards > Widgets > Powerpack Widget
---

# Powerpack Widget

## Overview{% #overview %}

{% alert level="info" %}
Powerpack widgets are not supported on screenboards.
{% /alert %}

Powerpacks are templated groups of widgets that scale graphing expertise as reusable dashboard building blocks. Powerpacks are either preset (created by Datadog, available to all customers) or custom (created by a user, and only available within their organization). For more information on Powerpack best practices, see the [Scale Graphing expertise with Powerpacks](https://docs.datadoghq.com/dashboards/guide/powerpacks-best-practices/) guide.

## Setup{% #setup %}

### Creating a Powerpack{% #creating-a-powerpack %}

Create a Powerpack from an existing group on a dashboard:

{% image
   source="https://docs.dd-static.net/images/dashboards/widgets/powerpack/group_header_icons.f85b97a04acf611b4e74eeedcd1f06b1.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/widgets/powerpack/group_header_icons.f85b97a04acf611b4e74eeedcd1f06b1.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Dashboard group header icons highting the Save as Powerpack icon option" /%}

1. From a dashboard group's header, click the Save as Powerpack icon.
1. Fill out details to make the Powerpack discoverable to your organization.
1. Add tags under Add Search Categories to organize your Powerpacks. This allows team members to find the correct Powerpack to add to their dashboard.
1. Choose which filters should be configurable for the users of the Powerpack.

**Note**: After creating a Powerpack, the original group is replaced with an instance of the Powerpack.

### Updating a Powerpack{% #updating-a-powerpack %}

Changes to a Powerpack sync across all dashboards where your Powerpack is used.

To make changes to the look or layout of a Powerpack:

1. Hover over the header and click the kebab menu.
1. Select Edit Powerpack Layout from the Powerpack Actions menu. **Note**: Powerpack layouts cannot be edited on timeboards.
1. Make any desired changes to the Powerpack layout or any individual widget and select Confirm Changes.
1. If this Powerpack is used in multiple dashboards, a prompt opens up to verify the instances of the Powerpack that are affected by this update.

{% image
   source="https://docs.dd-static.net/images/dashboards/widgets/powerpack/powerpack_actions_menu.c11c5565d530e4e724be470a351f25e9.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/widgets/powerpack/powerpack_actions_menu.c11c5565d530e4e724be470a351f25e9.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Action menu options to update a Powerpack and the Powerpack instance accessed through kebab on Powerpack header" /%}

To make changes to the Powerpack Details:

1. Hover over the header and click the kebab menu.
1. Select Edit Powerpack Details from the Powerpack Actions menu.
1. Make changes to the Powerpack info, the search categories, or filter configuration and select Update Powerpack.
1. If this Powerpack is used in multiple dashboards, a prompt opens to verify the instances of the Powerpack that are affected by this update.

**Note**: You must have edit permissions to make any updates to the Powerpack or to modify the permissions.

## Using Powerpacks{% #using-powerpacks %}

### Add or remove a Powerpack instance{% #add-or-remove-a-powerpack-instance %}

After you create a Powerpack, you can add an instance of that Powerpack to multiple dashboards.

To add a Powerpack instance to the dashboard:

1. Click Add Widgets to open the widget tray.
1. Click the Powerpacks tab to view available Powerpacks. You can search with text or predefined tags.
1. Click the desired Powerpack to open the configuration for the Powerpack instance.
1. Select filter values and how the filters are controlled.
   - Powerpack filters - the selected value applies to widgets inside the Powerpack instance.
   - Dashboard filters - controlled by dashboard template variables.
1. Click Confirm.

To remove a powerpack instance from the dashboard:

1. Click the kebab menu on the instance header.
1. Select Remove from Dashboard.

### Customizing a Powerpack instance{% #customizing-a-powerpack-instance %}

Changes to a Powerpack instance **do not** apply to other Powerpack instances in other dashboards.

To customize Powerpack instances displayed on your dashboard:

1. Click the kebab menu on the instance header.
1. Select an option from the Powerpack Actions menu:
   1. Edit Display Options: Customize the group header style, display colors, and name.
   1. Detach Instance: Unlink the instance from the original Powerpack.
   1. Remove from Dashboard: Remove the instance from the dashboard.
   1. Edit Powerpack Layout: Customize the layout of the widgets in the instance.
   1. Edit Powerpack Details: Customize the title, description, and associated tags.
1. Choose new styling options for the header, update the group title, or configure the filters used by your Powerpack.
1. Configure the tag values of your Powerpack instance.

{% image
   source="https://docs.dd-static.net/images/dashboards/widgets/powerpack/instance_configuration_modal.2339b00ff6c5e7baad3fcfe51aaec8dd.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/dashboards/widgets/powerpack/instance_configuration_modal.2339b00ff6c5e7baad3fcfe51aaec8dd.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Configuration options for a Powerpack instance" /%}

## Deleting a Powerpack{% #deleting-a-powerpack %}

Only the author of a Powerpack can delete it. After you delete a Powerpack, existing instances of the Powerpack remain intact, but they display an alert indicating the Powerpack has been deleted. To remove this alert, detach the instance and convert it into a widget group.

To delete a Powerpack:

1. Click Add Widgets to open the widget tray.
1. Select Delete Powerpack.

## Powerpack permissions{% #powerpack-permissions %}

To make changes to the edit permissions for a Powerpack:

1. Hover over the header and click the kebab menu.
1. Select Modify Permissions from the Powerpack Actions menu.
1. Update which users have edit permissions for the Powerpack.

## API{% #api %}

This widget can be used with the **[Dashboards API](https://docs.datadoghq.com/api/latest/dashboards/)**. See the following table for the [widget JSON schema definition](https://docs.datadoghq.com/dashboards/graphing_json/widget_json/):

{% tab %}
ModelExample
{% tab title="-model" %}
Expand AllFieldTypeDescriptionbackground_colorstringBackground color of the powerpack title.banner_imgstringURL of image to display as a banner for the powerpack.powerpack_id [*required*]stringUUID of the associated powerpack.show_titlebooleanWhether to show the title or not.
default: `true`
 template_variablesobjectPowerpack template variables. controlled_by_powerpack[object]Template variables controlled at the powerpack level.name [*required*]stringThe name of the variable.prefixstringThe tag prefix associated with the variable.values [*required*][string]One or many template variable values within the saved view, which will be unioned together using `OR` if more than one is specified. controlled_externally[object]Template variables controlled by the external resource, such as the dashboard this powerpack is on.name [*required*]stringThe name of the variable.prefixstringThe tag prefix associated with the variable.values [*required*][string]One or many template variable values within the saved view, which will be unioned together using `OR` if more than one is specified.titlestringTitle of the widget.type [*required*]enumType of the powerpack widget. Allowed enum values: `powerpack`
default: `powerpack`
{% /tab %}

{% tab title="example" %}

```json
{
  "background_color": "string",
  "banner_img": "string",
  "powerpack_id": "df43cf2a-6475-490d-b686-6fbc6cb9a49c",
  "show_title": false,
  "template_variables": {
    "controlled_by_powerpack": [
      {
        "name": "host1",
        "prefix": "string",
        "values": [
          "my-host",
          "host1",
          "host2"
        ]
      }
    ],
    "controlled_externally": [
      {
        "name": "host1",
        "prefix": "string",
        "values": [
          "my-host",
          "host1",
          "host2"
        ]
      }
    ]
  },
  "title": "string",
  "type": "powerpack"
}
```

{% /tab %}

{% /tab %}

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

- [Scale Graphing Expertise with Powerpacks](https://docs.datadoghq.com/dashboards/guide/powerpacks-best-practices/)
- [Save dashboard widgets in reusable groups with Powerpacks](https://www.datadoghq.com/blog/standardize-dashboards-powerpacks-datadog/)
- [Group Widget](https://docs.datadoghq.com/dashboards/widgets/group/)
- [Building Dashboards using JSON](https://docs.datadoghq.com/dashboards/graphing_json/)