Skip to content
MSO CloudDocumentation

Provision a new organization

On this page

Create an organization with the blueprint for its shape, so it opens on day one with a brand, a menu and a dashboard, ready to connect data.

Before you start#

  • You are a super admin; the organization directory at /admin/orgs is not reachable from inside a tenant.
  • Pick the shape first: Organization types explains what each blueprint turns on and where its members land.
  • Have the customer's slug, subdomain, language, currency and time zone to hand.
Create organizationNew organizationIDENTITYNameAcme RetailSlug · lowercase, dashes onlyacme-retailSubdomainacme1LOCALE & FORMATDefault localevi (Vietnamese)Default currencyVNDTimezoneAsia/Ho_Chi_Minh2FLAGSActive (members can log in)Sample data tenantPROVISIONINGBlueprint · preloads plugins, pages and menuOrganization datasets · Human resources3A workspace for an org that runs on its own datasets(people, finance...). Includes the domain layer: Human resources.CancelCreate4Organization: Acme Retail/admin/orgsORGANIZATION BLUEPRINTBlueprintStandard dashboard packPreviewApply56Preview (nothing written)N features · M dashboardsDomain layers: ecom, marketingApply shows the same box headed "Applied", with each pack's install status.Organization directoryone row per organizationOrganizationMembersBlueprintAcme Retail12Standard dashboard packv4 → v57Blue Media6Marketing analyticsup to dateNorth HR41Org. datasets · HRup to dateThe button shows only when the applied version is behind the registry.Upgrading keeps every dashboard card an operator already edited.
Left: the Create organization panel (steps 1-4). Right: the organization drawer's Blueprint section (steps 5-7).

Steps#

  1. At /admin/orgs select New organization ("Tổ chức mới") and fill in Name, Slug (lowercase, dashes only) and Subdomain.
  2. Set Default locale, Default currency and Timezone; leave Active on and Sample data tenant off for a real customer.
  3. Choose the Blueprint ("Gói khởi tạo"). The list holds the base shapes plus the four domain shapes; the description under the field names the domain layer it includes.
  4. Select Create. A default brand is created first, then the blueprint applies on top of it.
  5. To change or refresh an existing organization, open its row, choose a blueprint and select Preview ("Xem trước"). Preview computes the exact result an apply would return without writing anything.
  6. Select Apply ("Áp dụng"). Applying the same key again is repeatable: it upgrades to the latest version and never duplicates.
  7. When a row shows a v4 → v5 button, the applied version is behind the registry; select it to upgrade. The upgrade installs what is missing and keeps every dashboard card an operator already edited.

Extra plugins live at /admin/orgs/<slug>/plugins; LDAP, OpenID Connect and white-label are switches in the organization's drawer, not plugins (LDAP/AD login, White-label). Data is connected inside the organization at Connectors ("Kết nối").

Blueprint catalog#

E-commerceMarketingCRMCustomerconversationsMarket dataHumanresourcesFinanceWarehouseRefuses an orgwith marketplaceconnectionsStandard commerceStandard dashboard packMarketing analyticsMarket data onlyContent IntelligenceOrganization datasetsOrganization datasets · Human resourcesOrganization datasets · FinanceOrganization datasets · Warehousepillar turned onnot part of the shapeapply is refused while a marketplace connection is activeThe three domain shapes are Organization datasets plus one domain layer; applying the same key again upgrades the layer in place.
Which pillars each blueprint shape turns on. The last column marks the shapes that refuse an organization with an active marketplace connection.
Form key Shown as Base blueprint
standard-commerce Standard commerce itself
standard-dashboard-pack Standard dashboard pack itself
marketing-analytics Marketing analytics itself
market-intelligence-only Market data only itself
content-intelligence Content Intelligence itself
dataset-workspace Organization datasets itself
hr-workspace Organization datasets · Human resources dataset-workspace
finance-workspace Organization datasets · Finance dataset-workspace
warehouse-workspace Organization datasets · Warehouse dataset-workspace
panel-workspace Organization datasets · Multi-dimension panel dataset-workspace

A domain shape is the Organization datasets blueprint plus one domain layer (its fields, pages and morning-brief item); the domain layer is bundled, never a separate step.

Verify#

Sign in as a member of the organization, not as a super admin, and click every item on the navigation bar. A hidden menu item still opens by URL, so a page that renders when typed proves nothing.

  • Every menu item opens without a 404.
  • The page opened after sign-in is not empty. To choose it, see Set the default page and brand.
  • A domain shape shows its pages with a brand in the filter.
  • Before data is connected, pages show an empty state with guidance, never a zero.

Troubleshoot#

Symptom Cause Fix
Apply result says the organization has no brand An older organization created before brands were automatic Create a brand at /settings/brands, then apply again.
Apply is refused for a dataset or conversation shape The organization has an active marketplace connection Disable the marketplace connection first, or pick another shape.
A dataset pack shows "no such pack" The pack is declared but not in this build Platform work; the screen cannot resolve it.
The customer's shape is not in the list No blueprint declares it Add a registry entry; never script a one-off organization.