Start modules per role

Settings → Start Modules maps each role to a default homepage route. When someone logs in, EDGE Sword redirects them to that module instead of the generic dashboard — when their role defines one.

Configure start modules

1. Open Settings → Start Modules under MODULES & AI
2. For each role, pick a module from the dropdown
3. Click Save Changes

Only roles that changed are updated via the roles API. Choosing Dashboard clears the custom start module (saved as the default).

Available destinations

The dropdown is built from navigation items that expose a moduleId, plus Dashboard as the fallback. Sub-routes appear only when they target a different module than their parent (so FMCG sub-pages do not overwrite the FMCG dashboard entry).

Role type	Typical start module
Sales	Deals or Pulse
Finance	Invoices or Payments
Operations	Logistics or Picking
HR	Employees or My Info
Executive	Dashboard

Ensure the chosen module is enabled for the workspace — see Enable and manage modules. Users still need module permissions from their role; see Roles, permissions, and RBAC.

Please note:

• System roles appear in the list with a System Role badge; you can still assign start modules where policy allows.
• If no roles exist yet, create them under Roles in Settings before configuring start modules.
• Assign roles to people on Manage members — start modules apply only after a user has a role.

sequenceDiagram
  participant User
  participant Auth
  participant Router
  participant Module
  User->>Auth: Sign in
  Auth->>Router: Resolve role.startModule
  alt Custom start module set
    Router->>Module: Redirect to module home
  else Default
    Router->>Module: Redirect to Dashboard
  end

Permissions

Permission	Why you need it
settings.view	Open Start Modules in the drawer
settings.update	Save role start module changes
roles.read	Load the role list and current values

Related articles

• Workspace-wide module toggles: Configure your workspace
• Settings drawer map: Settings overview
• Team structure for read_team permissions: Manage teams
• Onboarding new users after role setup: Add users and invite teammates