Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Editing a custom insight

Focus mode
Editing a custom insight - AWS Security Hub

You can edit an existing custom insight to change the grouping value and filters. After you make the changes, you can save the updates to the original insight, or save the updated version as a new insight.

In AWS Security Hub, custom insights can be used to collect a specific set of findings and track issues that are unique to your environment. For background information about custom insights, see Understanding custom insights in Security Hub.

To edit a custom insight, choose your preferred method, and follow the instructions.

Security Hub console
To edit a custom insight (console)
  1. Open the AWS Security Hub console at https://console.aws.amazon.com/securityhub/.

  2. In the navigation pane, choose Insights.

  3. Choose the custom insight to modify.

  4. Edit the insight configuration as needed.

    • To change the attribute used to group findings in the insight:

      1. To remove the existing grouping, choose the X next to the Group by setting.

      2. Choose the search box.

      3. Select the attribute to use for grouping.

      4. Choose Apply.

    • To remove a filter from the insight, choose the circled X next to the filter.

    • To add a filter to the insight:

      1. Choose the search box.

      2. Select the attribute and value to use as a filter.

      3. Choose Apply.

  5. When you complete the updates, choose Save insight.

  6. When prompted, do one of the following:

    • To update the existing insight to reflect your changes, choose Update <Insight_Name> and then choose Save insight.

    • To create a new insight with the updates, choose Save new insight. Enter an Insight name, and then choose Save insight.

Security Hub API
To edit a custom insight (API)
  1. Use the UpdateInsight operation of the Security Hub API. If you use the AWS CLI run the update-insight command.

  2. To identify the custom insight that you want to update, provide the insight's Amazon Resource Name (ARN). To get the ARN of a custom insight, use the GetInsights operation or the get-insights command.

  3. Update the Name, Filters, and GroupByAttribute parameters as needed.

The following example updates the specified insight. This example is formatted for Linux, macOS, or Unix, and it uses the backslash (\) line-continuation character to improve readability.

$ aws securityhub update-insight --insight-arn "arn:aws:securityhub:us-west-1:123456789012:insight/123456789012/custom/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" --filters '{"ResourceType": [{ "Comparison": "EQUALS", "Value": "AwsIamRole"}], "SeverityLabel": [{"Comparison": "EQUALS", "Value": "HIGH"}]}' --name "High severity role findings"
PowerShell
To edit a custom insight (PowerShell)
  1. Use the Update-SHUBInsight cmdlet.

  2. To identify the custom insight, provide the insight's Amazon Resource Name (ARN). To get the ARN of a custom insight, use the Get-SHUBInsight cmdlet.

  3. Update the Name, Filter, and GroupByAttribute parameters as needed.

Example

$Filter = @{ ResourceType = [Amazon.SecurityHub.Model.StringFilter]@{ Comparison = "EQUALS" Value = "AwsIamRole" } SeverityLabel = [Amazon.SecurityHub.Model.StringFilter]@{ Comparison = "EQUALS" Value = "HIGH" } } Update-SHUBInsight -InsightArn "arn:aws:securityhub:us-west-1:123456789012:insight/123456789012/custom/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -Filter $Filter -Name "High severity role findings"
To edit a custom insight (console)
  1. Open the AWS Security Hub console at https://console.aws.amazon.com/securityhub/.

  2. In the navigation pane, choose Insights.

  3. Choose the custom insight to modify.

  4. Edit the insight configuration as needed.

    • To change the attribute used to group findings in the insight:

      1. To remove the existing grouping, choose the X next to the Group by setting.

      2. Choose the search box.

      3. Select the attribute to use for grouping.

      4. Choose Apply.

    • To remove a filter from the insight, choose the circled X next to the filter.

    • To add a filter to the insight:

      1. Choose the search box.

      2. Select the attribute and value to use as a filter.

      3. Choose Apply.

  5. When you complete the updates, choose Save insight.

  6. When prompted, do one of the following:

    • To update the existing insight to reflect your changes, choose Update <Insight_Name> and then choose Save insight.

    • To create a new insight with the updates, choose Save new insight. Enter an Insight name, and then choose Save insight.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.