docs/docs/en/multi-app/multi-portal/index.md
A portal is used to provide multiple access entries within the same application.
Each portal can have its own:
The Multi-portal plugin provides the following capabilities:
With these capabilities, you can provide different experiences for different roles while sharing the same data and business capabilities.
In real business scenarios, different roles often need different interfaces.
For example, in a retail management system:
Retail Management System
├─ Headquarters Portal
├─ Store Portal
├─ Distributor Portal
└─ Mobile Portal
Headquarters staff focus on:
Store staff focus on:
Distributors focus on:
Although everyone uses the same system, different roles do not need to see the same menus and pages.
That is exactly the problem portals solve.
Each portal has its own menu tree.
Menus in different portals do not affect each other.
For example:
Headquarters Portal
├─ Product Management
├─ Supply Chain Management
└─ Data Analysis
Store Portal
├─ Cashiering
├─ Order Management
└─ Stocktaking
Pages belong to their respective portals.
The same page can also be shown only in specific portals.
This makes it possible to design completely different workflows for different roles.
Portals themselves can be configured with access permissions.
Only authorized users can access the corresponding portal.
Unauthorized portals:
After enabling the Multi-portal plugin, the system provides two built-in portals by default:
| Portal | Path | Purpose |
|---|---|---|
| Desktop | /v/admin | Desktop entry |
| Mobile | /v/mobile | Mobile entry |
Access path:
/v/admin
Access path:
/v/mobile
In addition to the built-in portals, you can create more portals based on business needs.
For example:
After creation, you can configure:
Users can quickly switch between portals through the portal switcher.
Add it to the portal switcher panel in the upper-left corner
Add it to the action panel block
After enabling Multi-app and configuring SSO, users can also switch between portals across different apps through the portal switcher.
Add it to the portal switcher panel in the upper-left corner
Add it to the action panel block
You can control which portals a user can access through role permissions.
Unauthorized portals do not appear in the portal switcher list, and users cannot access those entries directly.
For the differences and combination patterns among Multi-portal, Multi-app, and Multi-space, see: Multi-portal, Multi-app, and Multi-space.