From a9ae018c40025ce51d6b39d56d1412d3cc17e273 Mon Sep 17 00:00:00 2001
From: mffap <mpa@zitadel.com>
Date: Mon, 8 Jan 2024 14:59:45 +0200
Subject: [PATCH] docs: Update settings, billing for mange cloud (#7169)

docs: portal settings
---
 docs/docs/guides/manage/cloud/billing.md  | 14 ++++++--
 docs/docs/guides/manage/cloud/settings.md | 42 +++++++++++++++++++++++
 2 files changed, 54 insertions(+), 2 deletions(-)
 create mode 100644 docs/docs/guides/manage/cloud/settings.md

diff --git a/docs/docs/guides/manage/cloud/billing.md b/docs/docs/guides/manage/cloud/billing.md
index a5bfbddb9a..5f7beba4e9 100644
--- a/docs/docs/guides/manage/cloud/billing.md
+++ b/docs/docs/guides/manage/cloud/billing.md
@@ -13,10 +13,11 @@ At the moment we provide only "Credit Card" payment
 
 Once a payment method is configured, it can be selected directly in the instance creation process.
 
-## Customer 
+## Customer
 
 To be able to create correct billings we will need some customer information from you.
 This includes the following fields:
+
 - Name
 - Country
 - Email address
@@ -25,6 +26,16 @@ This includes the following fields:
 - Postal Code
 - City
 
+## Tax ID
+
+If available, enter your tax ID type and VAT number.
+The tax ID will be shown on the invoice.
+
+:::info Reverse Charge
+When you enter the tax ID we will automatically calculate taxability.
+Depending on your billing address we will mark the invoice as reverse charge.
+:::
+
 ## Update Billing Information
 
 You will only need to add billing information if your instance is in the paid tier. There are two options on how to add your billing info.
@@ -32,7 +43,6 @@ You will only need to add billing information if your instance is in the paid ti
 2. Go to the billing menu and add a new payment method. You will be able to choose the added method, when upgrading the instance to the paid tier.
 3. Add the billing information directly during the upgrade process.
 
-
 ## Invoices
 
 We show all you invoices, and you are able to download them directly in the Customer Portal.
\ No newline at end of file
diff --git a/docs/docs/guides/manage/cloud/settings.md b/docs/docs/guides/manage/cloud/settings.md
new file mode 100644
index 0000000000..f4c4543ec7
--- /dev/null
+++ b/docs/docs/guides/manage/cloud/settings.md
@@ -0,0 +1,42 @@
+---
+title: Settings
+---
+
+Manage your team, email subscriptions, and billing information on the [Settings](https://zitadel.com/admin/settings) page.
+
+## Team name
+
+Change your ZITADEL Cloud team name by entering a new name.
+Confirm the changes by clicking the Change button.
+
+## Notifications and newsletters
+
+You can subscribe and unsubscribe to notifications and newsletters:
+
+- Onboarding: Welcome information for new users
+- Newsletter: Regular newsletter on ZITADEL
+- Product News: Receive product updates
+- Security: Receive notifications related to security issues
+
+:::info Technical Advisories
+If you want to stay up to date on our technical advisories, we recommend [subscribing here to the mailing list](https://zitadel.com/docs/support/technical_advisory#subscribe-to-our-mailing-list).
+
+Technical advisories are notices that report major issues with ZITADEL Self-Hosted or the ZITADEL Cloud platform that could potentially impact security or stability in production environments.
+:::
+
+You can also manage your subscriptions by clicking the unsubscribe link in the emails.
+
+:::info Mandatory Information
+We are required to inform you about changes to the terms of service or based on regulatory requirements. You can't unsubscribe to these notifications.
+:::
+
+## Delete team
+
+Permanently delete your ZITADEL Cloud account.
+This will delete your team and delete all associated information.
+
+Click **Delete Account** and confirm the next step.
+
+## Update billing information
+
+Refer to the [billing guide](./billing.md).