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/orgsis 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.
Steps#
- At
/admin/orgsselect New organization ("Tổ chức mới") and fill in Name, Slug (lowercase, dashes only) and Subdomain. - Set Default locale, Default currency and Timezone; leave Active on and Sample data tenant off for a real customer.
- 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.
- Select Create. A default brand is created first, then the blueprint applies on top of it.
- 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.
- Select Apply ("Áp dụng"). Applying the same key again is repeatable: it upgrades to the latest version and never duplicates.
- When a row shows a
v4 → v5button, 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#
| Form key | Shown as | Base blueprint |
|---|---|---|
standard- |
Standard commerce | itself |
standard- |
Standard dashboard pack | itself |
marketing- |
Marketing analytics | itself |
market- |
Market data only | itself |
content- |
Content Intelligence | itself |
dataset- |
Organization datasets | itself |
hr- |
Organization datasets · Human resources | dataset- |
finance- |
Organization datasets · Finance | dataset- |
warehouse- |
Organization datasets · Warehouse | dataset- |
panel- |
Organization datasets · Multi-dimension panel | dataset- |
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 /, 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. |