+
+{% capture personal %}
+
+#### From the My Vault view
+
+To create a new shared item:
+
+1. On the {% icon fa-lock %} **My Vault** page, select the {% icon fa-plus %} **Add Item** button.
+2. Fill in all the relevant information for the new Vault item.
+3. In the **Ownership** section at the bottom of the Add Item panel, choose the Organization you want to share this item with.
+4. Select one or more **Collections** to share this item into. You must select _at least_ one Collection.
+5. Select the **Save** button to finishing creating the shared item.
+
+Creating a shared item **will set ownership to the Organization**. This means that anyone with permission can alter the item or delete it, which would remove it from your Vault as well. You can tell that an item is shared when it has the {% icon fa-cube %} **Shared** icon next to its name:
+
+{% image /organizations/collection-shared-item.png Shared Item icon %}
+
+{% endcapture %}
+{{ personal | markdownify }}
+
+
+
+{% capture organization %}
+
+#### From the Organization view
+
+To create a new shared item:
+
+1. On your Organization's {% icon fa-lock %} **Vault** tab, select the {% icon fa-plus %} **Add Item** button.
+2. Fill in all the relevant information for the new Vault item.
+3. The Ownership of the item is automatically set to the Organization when you use this method, so all you need to do is select one or more **Collections** to share this item into. You must select _at least_ one Collection.
+4. Select the **Save** button to finishing creating the shared item.
+
+Creating a shared item or sharing an item **will set ownership to the Organization**. This means that anyone with permission can alter the item or delete it, which would remove it from your Vault as well. You can tell that an item is shared when it has the {% icon fa-cube %} **Shared** icon next to its name:
+
+{% image /organizations/collection-shared-item.png Shared Item icon %}
+
+{% endcapture %}
+{{ organization | markdownify }}
+
+
+
diff --git a/_articles/plans-and-pricing/organization-renewal.md b/_articles/plans-and-pricing/organization-renewal.md
index 57dc4d59..391d832b 100644
--- a/_articles/plans-and-pricing/organization-renewal.md
+++ b/_articles/plans-and-pricing/organization-renewal.md
@@ -16,9 +16,9 @@ As your renewal date approaches, Bitwarden recommends that you validate the paym
{% callout warning %}
If we cannot process your payment method, or if you have cancelled your subscription, your Organization will be disabled. For **self-hosted customers**, there is a 2 month grace period between expiration of your [license]({{site.baseurl}}/article/licensing-on-premise/#organization-license) and disabling of your Organization. In either case, a disabled Organization will result in the following:
-**Shared Vault Items**
+**Organization-owned Vault Items**
-[Owners]({{site.baseurl}}/article/user-types-access-control/) will retain access to [shared Vault items]({{site.baseurl}}/article/share-to-a-collection), however all other users will lose access to these items. Shared Vault items and existing [Collections]({{site.baseurl}}/article/about-collections/) **will not be deleted**.
+[Owners]({{site.baseurl}}/article/user-types-access-control/) will retain access to [shared Vault items]({{site.baseurl}}/article/sharing), however all other users will lose access to these items. Organization Vault items and existing [Collections]({{site.baseurl}}/article/about-collections/) **will not be deleted**.
**Organization Users**
diff --git a/_articles/plans-and-pricing/upgrade-from-individual-to-org.md b/_articles/plans-and-pricing/upgrade-from-individual-to-org.md
index 1ae2a89c..8e67743f 100644
--- a/_articles/plans-and-pricing/upgrade-from-individual-to-org.md
+++ b/_articles/plans-and-pricing/upgrade-from-individual-to-org.md
@@ -8,7 +8,7 @@ hidden: false
tags: [account, individual, organization, premium, subscription]
order: 03
---
-This article will guide existing individual Bitwarden users ([**Free**](https://bitwarden.com/help/article/about-bitwarden-plans/#free-individual) or [**Premium**](https://bitwarden.com/help/article/about-bitwarden-plans/#premium-individual)) through the process of transitioning to an Organizations plan ([**Free**](https://bitwarden.com/help/article/about-bitwarden-plans/#free-organizations), [**Families**](https://bitwarden.com/help/article/about-bitwarden-plans/#families-organizations), [**Teams**](https://bitwarden.com/help/article/about-bitwarden-plans/#teams-organizations), or [**Enterprise**](https://bitwarden.com/help/article/about-bitwarden-plans/#enterprise-organizations)) in order to start securely sharing data between friends, family, co-workers, a department, or an entire company.
+This article will guide existing individual Bitwarden users ([**Free**](https://bitwarden.com/help/article/about-bitwarden-plans/#free-individual) or [**Premium**](https://bitwarden.com/help/article/about-bitwarden-plans/#premium-individual)) through the process of transitioning to an Organizations plan ([**Free**](https://bitwarden.com/help/article/about-bitwarden-plans/#free-organizations), [**Families**](https://bitwarden.com/help/article/about-bitwarden-plans/#families-organizations), [**Teams**](https://bitwarden.com/help/article/about-bitwarden-plans/#teams-organizations), or [**Enterprise**](https://bitwarden.com/help/article/about-bitwarden-plans/#enterprise-organizations)) in order to start securely sharing data from Organizations with friends, family, co-workers, a department, or an entire company.
## Start Your Organization
@@ -66,4 +66,4 @@ Now that you've created your Organization, we recommend that you:
- [Invite Users to Your Organization](https://bitwarden.com/help/article/managing-users)
- [Create a Collection](https://bitwarden.com/help/article/about-collections/#create-a-collection)
-- [Share Items to a Collection](https://bitwarden.com/help/article/share-to-a-collection/)
+- [Share Items to a Collection](https://bitwarden.com/help/article/sharing/)
diff --git a/_articles/providers/add-existing-client-org.md b/_articles/providers/add-existing-client-org.md
new file mode 100644
index 00000000..1c2762ce
--- /dev/null
+++ b/_articles/providers/add-existing-client-org.md
@@ -0,0 +1,29 @@
+---
+layout: article
+title: Add Existing Organizations
+categories: [providers]
+featured: false
+popular: false
+hidden: false
+tags: []
+order: 05
+---
+
+MSPs, Resellers, and other Bitwarden Partners that are already administering Organizations on behalf of their clients can add pre-existing Organizations to their Provider Portal.
+
+When Bitwarden detects that a [Provider Admin's]({{site.baseurl}}/article/provider-users/#provider-user-types) account is the **Owner of a non-Provider Organization**, the Provider Portal will display an {% icon fa-plus %} **Add Existing Organization** button:
+
+{% image /providers/add-existing-client-1.png %}
+
+Selecting the {% icon fa-plus %} **Add Existing Organization** button prompts you to select the Organization to add to the Provider:
+
+{% image /providers/add-existing-client-2.png %}
+
+Once added, the Organization will appear in the {% icon fa-bank %} **Clients** list alongside all other Client Organizations.
+
+{% callout success %}
+**Once you've added the existing Organization to the Provider**, you (the Provider Admin and Organization Owner) can be removed from the Organization. Doing so will free up the User Seat previously taken up by your account. As a member of the Provider, you will retain all permission over the Client Organization:
+
+1. Organizations may not be Owner-less, so [add a backup Owner to the Organization]({{site.baseurl}}/article/managing-users/#invite).
+2. Once the new Owner is Invited, Accepted, and Confirmed, ask them to [remove you from the Organization]({{site.baseurl}}/article/managing-users/#offboard-users).
+{% endcallout %}
diff --git a/_articles/providers/client-org-setup.md b/_articles/providers/client-org-setup.md
new file mode 100644
index 00000000..94e4409c
--- /dev/null
+++ b/_articles/providers/client-org-setup.md
@@ -0,0 +1,67 @@
+---
+layout: article
+title: Start a Client Organization
+categories: [providers]
+featured: false
+popular: false
+hidden: false
+tags: []
+order: 04
+---
+
+This article will walk you through the [creation of a Client Organization](#create-a-client-organization) and outline a typical [setup procedure](#initial-setup-procedure) for getting started administering a customer's Organization.
+
+## Create a Client Organization
+
+{% callout success %}
+**Already have an Organization setup for your customer?** You can [add an existing Organization to the Provider Portal]({{site.baseurl}}/article/providers-faqs/#q-can-i-add-an-existing-organizations-to-my-provider).
+{% endcallout %}
+
+To create a Client Organization you must be a [Provider Admin]({{site.baseurl}}/article/provider-users/#provider-user-types):
+
+1. Navigate to the Provider Portal and select the {% icon fa-plus %} **New Client Organization** button:
+
+ {% image providers/provider-add-client.png Create a Client Organization %}
+2. On the New Client Organization screen, enter an **Organization Name**, **Billing Email**, and **Client Owner Email**.
+
+ {% callout info %}An invitation will automatically be sent to the **Client Owner Email** to join the Organization as an [Owner]({{site.baseurl}}/article/user-types-access-control).{% endcallout %}
+3. From the **Choose Your Plan** list, select the [type of Organization]({{site.baseurl}}/article/about-bitwarden-plans/#compare-the-plans-1) to create.
+
+ {% callout success %}Teams and Enterprise Organizations include premium features for all enrolled users.{% endcallout %}
+4. Set the following options for the Organization:
+
+ - **User Seats**: Specify the number of User Seats you need for the Client Organization. You can always add more seats later.
+ - **Additional Storage (GB)**: Organizations come with 1GB of encrypted [storage for attachments]({{site.baseurl}}/article/attachments/). Add additional storage for $0.33 per GB per month.
+ - **Billing Cadence**: Choose whether you'd like to be billed for this Organization Annually or Monthly.
+
+5. Once you're happy with the Organization, enter your **Payment Information** and select **Submit**.
+5. Select **Submit** to finishing creating the Organization.
+
+Once created, navigating to the Client Organization from the Provider Portal will bring you to the Organization Vault, from which you can fully complete [initial setup](#initial-setup-procedure) and engage in [ongoing administration]({{site.baseurl}}/article/manage-client-orgs/):
+
+{% image providers/client-org-manage.png Client Organization Vault %}
+
+## Initial Setup Procedure
+
+With your newly-created Client Organization, you're ready to start building the perfect solution for your customer. Exact setup will be different for each Client Organization depending on your customers' needs, but typically will involve the following steps:
+
+1. **Create Collections**. A good first step is to [create a set of Collections]({{site.baseurl}}/article/about-collections/#create-a-collection), which provide an organizing structure for the Vault items you'll add to the Vault in the next step.
+
+ Common Collections patterns include **Collections by Department** (i.e. users in the client's Marketing Team are assigned to a **Marketing** Collection) or **Collections by Function** (i.e. users from the client's Marketing Team are assigned to a **Social Media** Collection):
+
+ {% image organizations/collections-graphic-1.png %}
+2. **Populate the Organization Vault**. Once the structure of how you'll store Vault items is in place, you can begin populating the Organization with your client's Logins, Notes, Cards, and Identities.
+
+ {% callout success %}You can [create shared items from scratch]({{site.baseurl}}/article/sharing/#create-a-shared-item), but we recommend [importing a file that contains all their Vault items]({{site.baseurl}}/article/import-to-org/).{% endcallout %}
+3. **Configure Enterprise Policies**. Before beginning the user management portion of setup, [configure Enterprise Policies]({{site.baseurl}}/article/policies/) in order to set rules-of-use for things like [Master Password complexity]({{site.baseurl}}/article/policies/#master-password), [use of Two-step Login]({{site.baseurl}}/article/policies/#two-step-login), and [Admin Password Reset]({{site.baseurl}}/article/admin-reset/).
+
+ {% callout info %}Enterprise Policies are **only available to Enterprise Organizations**.{% endcallout %}
+4. **Setup Login with SSO**. If your customer uses Single Sign-On (SSO) to authenticate with other applications, [connect Bitwarden with their IdP]({{site.baseurl}}/article/about-sso/) to allow authentication with Bitwarden using end-users' SSO credentials.
+5. **Create User Groups**. For Teams and Enterprise Organizations, [create a set of Groups]({{site.baseurl}}/article/about-groups/#create-a-group) for scalable permissions assignment. When you start adding users, add them to Groups to have each user automatically inherit the Group's configured permissions (e.g. access to which Collections).
+
+ One common Group-Collection pattern is to create **Groups by Department** and **Collections by Function**, for example:
+
+ {% image organizations/collections-graphic-2.png %}
+6. **Start Inviting Users**. Now that the infrastructure for securely and scalably sharing credentials is in place for your client, you can begin [inviting users to the Organization]({{site.baseurl}}/article/managing-users/#onboard-users). To ensure the security of the Organization, Bitwarden applies a 3-step process for onboarding new users, Invite → Accept → Confirm.
+
+ {% callout success %}**If your customer uses directory service** (Active Directory, an LDAP, Okta, etc.), use [Directory Connector]({{site.baseurl}}/article/directory-sync/) to automatically sync Organization users from the source directory and automatically issue invitations.{% endcallout %}
diff --git a/_articles/providers/getting-started-providers.md b/_articles/providers/getting-started-providers.md
new file mode 100644
index 00000000..b313e63c
--- /dev/null
+++ b/_articles/providers/getting-started-providers.md
@@ -0,0 +1,106 @@
+---
+layout: article
+title: Get Started with Provider Portal
+categories: [providers]
+featured: false
+popular: false
+hidden: false
+tags: []
+order: 02
+redirect_from:
+ - /article/deploying-bitwarden-as-a-msp/
+---
+
+{% callout success %}
+Interested in becoming a Provider? Contact us to get started for free:
+
+