> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/cloud/membership/policies/delete.md).

# Delete a policy

Delete a custom policy.

**Where:** Membership → Policies → click a policy → **Actions** → **Delete** · `/projects/<project>/membership/policies/<policyId>/edit`

## Before you start

* Only custom policies can be deleted; on a system policy **Delete** is off.
* Check which roles carry the policy — they lose its permissions.
* You need the `membership:delete` permission on policies.

## Steps

1. Under **Custom Policies**, click the policy, for example `temp-policy`, and open **Actions**.

   <figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-0679a95b8f87f37e8e80ad17dae5c3593bf49dd3%2Fpolicies-delete-1.png?alt=media" alt="Editing policy temp-policy with the Actions menu open: See documentation and Delete"><figcaption><p>The <strong>Actions</strong> menu.</p></figcaption></figure>
2. Press **Delete**. The dialog **Delete Confirmation** asks *Are you sure you want to delete?*

   <figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-80b7ddad627b68afeba7db46f71afbaf244c81db%2Fpolicies-delete-2.png?alt=media" alt="Dialog Delete Confirmation: Are you sure you want to delete? with Cancel and Delete"><figcaption><p>The confirmation dialog.</p></figcaption></figure>
3. Press **Delete**.

## Result

Cloud goes back to **Policies**; the policy is gone from **Custom Policies**.

<figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-aaa1679b39bf5380fb54e03002c2294aacfa45f3%2Fpolicies-list-1.png?alt=media" alt="Custom Policies list with content-editing and orders-read"><figcaption><p>The list after the delete.</p></figcaption></figure>

## Change or remove it later

* A deleted policy cannot be brought back — [create it again](/codemash/cloud/membership/policies/new.md).

## Do it from code

```ts
await norbix.hub.membership.deletePolicy({ id }); // id: pol_…
```

```sh
norbix hub membership policy delete pol_55EQ74dP3HciwimFfkM5I1 --yes
```

The client setup is on the [Membership page](/codemash/cloud/membership.md#use-it-from-code). API: [Delete Policy](/codemash/api-reference/membership/policies/delete-policy.md)
