This page explains how to edit or delete reCAPTCHA keys (also known as *keys*).

To check which version (`v2` or `v3`) your key uses or to retrieve your site key
and legacy secret key for third-party CMS plugins (such as WordPress or
Shopify), see [Reconcile Admin Console and Google Cloud console
terminology](https://docs.cloud.google.com/recaptcha/docs/reconcile-legacy-terminology).

## Before you begin

Ensure that you have the following Identity and Access Management role: reCAPTCHA Enterprise Admin
(`roles/recaptchaenterprise.admin`).

The simplest way to edit or delete a reCAPTCHA key is through the Google Cloud console.
Alternatively, you can use the reCAPTCHA Enterprise API or the
Google Cloud CLI.

## Edit a reCAPTCHA key

You can edit only some attributes of a reCAPTCHA key. You cannot change the
platform type of a reCAPTCHA key. For example, if a
reCAPTCHA key was created for a website, you cannot change the
platform type to Android or iOS.

> [!NOTE]
> **Note:** Changes to a reCAPTCHA key's settings or allowed domain list can take up to 30 minutes to take effect.

### Console

1. In the Google Cloud console, go to the **reCAPTCHA** page.

   [Go to reCAPTCHA](https://console.cloud.google.com/security/recaptcha)
2. Verify that the name of your project appears in the resource selector
   at the top of the page.

   If you don't see the name of your project, click the resource selector,
   and then select your project.
3. Select the **Keys** tab.

   The **Keys** tab has two views: **Table** and **Cards** .
   If your project has many reCAPTCHA keys, only the **Table** view is available.
4. In the **reCAPTCHA keys** section, identify the reCAPTCHA key you want
   to edit.

5. For the reCAPTCHA key, click
   **View key actions** and then select **Edit key**.

6. On the **Edit the reCAPTCHA key** page, edit the required fields,
   and click **Update key**.

### gcloud

To edit reCAPTCHA keys, use the [`gcloud recaptcha keys update`](https://docs.cloud.google.com/sdk/gcloud/reference/recaptcha/keys/update.md.txt) command.

### REST API

To edit reCAPTCHA keys, use the [`projects.keys.patch`](https://docs.cloud.google.com/recaptcha/docs/reference/rest/v1/projects.keys/patch.md.txt) method.

## Delete a reCAPTCHA key

If you delete a reCAPTCHA key from an active integration of reCAPTCHA,
the website or the mobile application can show errors to your users, and the
reCAPTCHA API calls
return errors.

After you delete reCAPTCHA keys, you cannot recover them.

### Console

1. In the Google Cloud console, go to the **reCAPTCHA** page.

   [Go to reCAPTCHA](https://console.cloud.google.com/security/recaptcha)
2. Verify that the name of your project appears in the resource selector
   at the top of the page.

   If you don't see the name of your project, click the resource selector,
   then select your project.
3. Select the **Keys** tab.

   The **Keys** tab has two views: **Table** and **Cards** .
   If your project has many reCAPTCHA keys, only the **Table** view is available.
4. In the **reCAPTCHA keys** section, identify the reCAPTCHA key you want
   to delete.

5. For the reCAPTCHA key, click **View key actions** and then select **Delete key**.

6. In the confirmation dialog, enter `DELETE` and click **Delete**.

### gcloud

To edit reCAPTCHA keys, use the [`gcloud recaptcha keys delete`](https://docs.cloud.google.com/sdk/gcloud/reference/recaptcha/keys/delete) command.

### REST API

To edit reCAPTCHA keys, use the [`projects.keys.delete`](https://docs.cloud.google.com/recaptcha/docs/reference/rest/v1/projects.keys/delete.md.txt) method.