Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 47 additions & 0 deletions content/manage-your-account/account-deletion.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
title: Account deletion
description: Learn how to permanently delete your Knock account and what happens to your data.
tags: ["account", "deletion", "delete"]
section: Manage your account
---

## Overview

Account owners can permanently delete their Knock account from the dashboard. This action is irreversible. Once you delete your account, all data associated with it is permanently removed and cannot be recovered.

## Before you delete

Consider the following before deleting your account:

- **Production workflows.** Deactivate or migrate any production workflows that are still sending notifications. Deleting your account will immediately stop all notification delivery.
- **API keys.** All API keys will be revoked immediately. Any applications or services using these keys will lose access to Knock.
- **Account members.** All [account members](/manage-your-account/managing-members) will lose access. They will receive an email informing them that the account has been deleted.
- **Integrations.** Any active channel integrations (email, push, chat, SMS) will stop working.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it worth adding a note about historical records / logs here? I know we cover that in the section below, so might be overkill.


Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it worth adding historical records / message logs here? I know it's addressed in the section below, so might be overkill.

## What happens to your data

When you delete your account, Knock permanently removes all data associated with it:

- **Account data.** Workflows, templates, layouts, assets, branding, and environment configuration
- **Recipient data.** Users, objects, tenants, and all associated data
- **Message history and logs.** Message logs, API logs, workflow run logs, and audit logs

For context on how Knock handles data during normal operation, see [data retention](/manage-your-account/data-retention).

## What happens to account members
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Noting that this wraps in the TOC. We could update this and then one above to Data deletion and Account member deletion? Couldn't think of any other good options.


All members are removed from the account when it is deleted. Each member receives an email informing them that the account has been deleted. Learn more about [managing account members](/manage-your-account/managing-members).

## How to delete your account

1. Open your account settings in the Knock dashboard.
2. Navigate to the **General** section.
3. Find the **Delete account** option and follow the prompts to confirm.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm assuming this is correct -- I couldn't find your control changes. Do you have them staging somewhere?

4. Enter your account slug to confirm the deletion.
5. Confirm the deletion. Your account and all associated data will be permanently removed after 24 hours.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are we going to show a confirmation modal/message? Wondering what "confirm the deletion" looks like. If there are any errors/issues, will we display a toast message informing them of the error and that the deletion wasn't successful?


<Callout
type="alert"
title="Note"
text="Account deletion is permanent and cannot be undone. Make sure you have exported or migrated any data you need before proceeding."
Comment on lines +45 to +46
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title="Note"
text="Account deletion is permanent and cannot be undone. Make sure you have exported or migrated any data you need before proceeding."
title="Account deletion is permanent and cannot be undone."
text="Make sure you have exported or migrated any data you need before proceeding."

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if it's better to have this right above the How to header? I don't have a strong opinion on that, but might be more noticeable there?

Comment on lines +45 to +46
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title="Note"
text="Account deletion is permanent and cannot be undone. Make sure you have exported or migrated any data you need before proceeding."
title="Account deletion is permanent and cannot be undone."
text="Make sure you have exported or migrated any data you need before proceeding."

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if this would be more noticeable above the How to header? I'm not sure.

/>
1 change: 1 addition & 0 deletions content/manage-your-account/roles-and-permissions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@ For a complete overview of which permissions are available to which roles, see o
columnsYes: ["Owner", "Admin"],
},
{ name: "Manage account branding", columnsYes: ["Owner", "Admin"] },
{ name: "Delete account", columnsYes: ["Owner"] },
],
},
{
Expand Down
1 change: 1 addition & 0 deletions data/sidebars/platformSidebar.ts
Original file line number Diff line number Diff line change
Expand Up @@ -212,6 +212,7 @@ export const PLATFORM_SIDEBAR: SidebarSection[] = [
{ slug: "/data-retention", title: "Data retention" },
{ slug: "/custom-domains", title: "Custom domains" },
{ slug: "/managing-assets", title: "Managing assets" },
{ slug: "/account-deletion", title: "Account deletion" },
],
},
];
Loading