# Virtual Deliverability Manager settings
<a name="vdm-settings"></a>

The Virtual Deliverability Manager Settings page provides controls for both SES deliverability and global deliverability. You can view or change settings at any time using the Amazon SES console or the AWS CLI.

## SES deliverability settings
<a name="vdm-settings-ses"></a>

SES deliverability settings control engagement tracking and optimized shared delivery at the account level. You can also define custom settings at the configuration set level to override account-level defaults.

### Changing SES deliverability settings using the Amazon SES console
<a name="vdm-settings-ses-console"></a>

**To change SES deliverability settings using the Amazon SES console**

1. Sign in to the AWS Management Console and open the Amazon SES console at [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. In the left navigation pane, choose **Settings** under **Virtual Deliverability Manager**.

1. To change **Engagement tracking** or **Optimized shared delivery** settings:

   1. In the **Additional settings** panel, choose **Edit**.

   1. Select the corresponding radio button to turn either feature on or off, and then choose **Submit settings**.
**Note**  
*Engagement tracking* options that you define here or in Virtual Deliverability Manager's configuration set overrides, control whether or not to report opens and clicks in the Virtual Deliverability Manager dashboard; they do not affect event destination configurations that publish open and click events. For example, if you have engagement tracking disabled here, it will not disable the open and click event publishing you have set up in [SES event destinations](event-destinations-manage.md).

1. (Optional) To define custom settings for how a configuration set uses engagement tracking and optimized shared delivery by overriding how they're defined in Virtual Deliverability Manager, reference [Virtual Deliverability Manager options](creating-configuration-sets.md#vdm-create-config-overrides) while creating or editing a configuration set.

1. To disable Virtual Deliverability Manager:

   1. In the **Subscription overview** panel, choose **Disable Virtual Deliverability Manager**.

   1. In the **Disable Virtual Deliverability Manager?** pop-up window, enter `Disable` in the confirmation field, and then choose **Disable Virtual Deliverability Manager**.

1. To reenable Virtual Deliverability Manager, see [Getting started with Virtual Deliverability Manager](vdm-get-started.md).

### Changing SES deliverability settings using the AWS CLI
<a name="vdm-settings-ses-cli"></a>

You can use the [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutAccountVdmAttributes.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutAccountVdmAttributes.html) and [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutConfigurationSetVdmOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutConfigurationSetVdmOptions.html) operations in the Amazon SES API v2 to change your SES deliverability settings.
+ Enable or disable engagement tracking, optimized shared delivery, or both using an input file:

  ```
  aws --region us-east-1 sesv2 put-account-vdm-attributes --cli-input-json file://attributes.json
  ```

  In this example, where engagement tracking is `ENABLED` and optimized shared delivery is `DISABLED`, the input file looks similar to this:

  ```
  {
      "VdmAttributes": {
          "VdmEnabled": "ENABLED",
          "DashboardAttributes": {
              "EngagementMetrics": "ENABLED"
          },
          "GuardianAttributes": {
              "OptimizedSharedDelivery": "DISABLED"
          }
      }
  }
  ```

  You can find more information about parameter values and related data types by linking from the [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_VdmAttributes.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_VdmAttributes.html) data type in the Amazon SES API v2 reference.
+ Define custom settings for how a configuration set will use engagement tracking and optimized shared delivery by overriding how they've been defined in Virtual Deliverability Manager:

  ```
  aws --region us-east-1 sesv2 put-configuration-set-vdm-options --cli-input-json file://config-set.json
  ```

  In this example, where a configuration set named *example* has both engagement tracking and optimized shared delivery enabled, the input file looks similar to this:

  ```
  {
      "ConfigurationSetName": "example",
      "VdmOptions": {
          "DashboardOptions": {
              "EngagementMetrics": "ENABLED"
          },
          "GuardianOptions": {
              "OptimizedSharedDelivery": "ENABLED"
          }
      }
  }
  ```

  For more information about parameter values and related data types, see the [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_VdmOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_VdmOptions.html) data type in the Amazon SES API v2 reference.
+ To verify the outcome:

  ```
  aws --region us-east-1 sesv2 get-configuration-set --configuration-set-name example
  ```
+ Not specifying [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DashboardOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DashboardOptions.html) or [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GuardianOptions.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GuardianOptions.html) options at the configuration set level results in your Virtual Deliverability Manager account-level settings applying to traffic sent through that configuration set.

## Global deliverability settings
<a name="vdm-settings-global"></a>

Global deliverability settings control domain monitoring, IP monitoring, and inbox placement testing. Global deliverability is enabled per region from the Virtual Deliverability Manager Settings page.

**To manage global deliverability settings using the Amazon SES console**

1. Sign in to the AWS Management Console and open the Amazon SES console at [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. In the left navigation pane, choose **Settings** under **Virtual Deliverability Manager**.

1. In the **Global deliverability** panel, you can:
   + Enable or disable global deliverability for the current region.
   + Choose **Edit domains** to select which of your verified sending domains to monitor.

For detailed instructions on enabling or disabling global deliverability, see [Getting started with global deliverability](vdm-gd-get-started.md). For more information about global deliverability features, see [Global deliverability](vdm-global-deliverability.md).