Relationships
Relationships
Overview
Relationships define the commercial and support hierarchy used by CMS. They connect distributors, partners, tenants, users, subscriptions, billing, commissions, documents, and dashboards.
Purpose
Use Relationships to create and manage the organisations that own or support tenants and subscriptions.
Relationship Hierarchy
Distributor
-> Partner
-> Tenant
-> Subscription
User Roles
| Role family | Typical relationship access |
|---|---|
| Platform roles | All distributors, partners, and tenants. |
| Distributor roles | Their distributor, partners, and tenants. |
| Partner roles | Their partner and tenants. |
| Tenant roles | Their tenant. |
Key Workflows
Create a Distributor
- Open Relationships.
- Select the distributor area.
- Choose New Distributor.
- Enter display name, description, billing contact, billing address, country, and currency.
- Review the summary and create the distributor.
Create a Partner
- Open Relationships.
- Select the partner area.
- Choose New Partner.
- Select the distributor.
- Enter partner details, billing details, and contact information.
- Review the summary and create the partner.
Create a Tenant
- Open Relationships.
- Select the tenant area.
- Choose New Tenant.
- Enter tenant details and billing details.
- Review the summary and create the tenant.
Configuration
Self-provisioning settings can allow or restrict delegated creation actions. Platform administrators can create relationship records directly. Read-only users can view records but cannot create or change them.
What To Check
If a user cannot create or edit a relationship record, check:
- The user's role.
- The user's distributor, partner, or tenant relationship.
- Whether the required parent record exists.
- Whether self-provisioning settings allow the action.
Related Pages
- Authentication and Users
- Subscriptions and Resource Groups
- Usage, Billing, and Invoicing
- Settings and Operations