Skip to main content

Admin Portal Navigation

This guide explains how you move through the Admin Portal: what you see in the header, how you reach tenant and platform tools, and how navigation changes by role and device. Use it alongside the broader documentation on Booga Enterprise Docs when you need deeper product context outside the app.

Overview​

The Admin Portal uses a page-based navigation pattern instead of a persistent sidebar. Each major administrative area is its own page. The main Admin Portal dashboard acts as a hub: from there you open specialized management pages for users, infrastructure, compliance, and more. You always know where you are from the page title at the top, and you can step back through a consistent back control rather than hunting through nested menus.

Header Navigation Bar​

Every Admin Portal page uses the same DashboardHeader pattern so the experience stays familiar.

  • Page title — Shows which administrative area you are in so you can confirm context at a glance.
  • Back button — Returns you to the appropriate parent screen. The label is contextual (for example Back to Admin Portal when you are inside a section, or Back to Dashboard when the logical parent is the main product dashboard). Rely on this label to understand where the button will take you.
  • User welcome — Reinforces which account you are using while you perform sensitive tasks.
  • Role badge — Displays your effective role. When you operate as a SuperUser, that badge appears in a secondary accent so platform operators can distinguish elevated sessions from standard admin work at a glance.
  • Action buttons — Primary actions for the current page appear in the header area, keeping workflows one step away from the content.

Together, these elements keep orientation clear: title for “where,” back for “up one level,” welcome and role for “who,” and actions for “what you can do here.”

Accessing the Admin Portal​

From the main dashboard, open the Admin Portal by clicking the admin icon or menu entry. The portal opens at /admin-portal/ — the Admin Portal home that aggregates links and shortcuts to the management areas you are allowed to use. Access requires an authenticated session; the app enforces sign-in before showing admin pages. If you are on a developer-oriented tenant experience, the product may route you toward subscription flows first so billing and plan status stay aligned with what you are allowed to configure—follow those prompts when they appear.

Admin Portal Sections​

From the main Admin Portal dashboard, management areas are grouped roughly by how prominently they appear. Use the labels below to match what you see on screen.

Primary actions (most prominent)

  • Subscription Management — Plans, billing alignment, and subscription-related controls for your tenant context.
  • User Management — Invite, configure, and oversee users in scope for your role.
  • Infrastructure Management — Environment and infrastructure settings your organisation is permitted to adjust.
  • Events Management — Operational and administrative events relevant to governance and oversight.

Secondary actions

  • Audit & Compliance — Review audit-oriented information and compliance-related tooling available to your tenant.
  • Notifications — Configure how and when administrative notifications are surfaced.
  • Permissions — Manage permission scopes for users and roles within the product’s admin model.
  • Site Customization — Adjust tenant-facing branding and configuration where your plan allows.

Separate link

  • Support Requests — Reach or track support interactions without mixing them into the primary grid of management tiles.

SuperUser-only areas

If you hold SuperUser privileges, you also get additional platform-wide tools that do not appear for standard tenant admins. These typically include Platform Management, Scheduler, Promotion Requests, Catalog, Features, Global Tenant Management, Invitations, and Global Customization. Exact availability still follows your organisation’s policies and feature flags.

Back Navigation​

Treat the header back control as the primary way to move “up” the hierarchy. It is wired to the logical parent for the page you are on: from a subsection back to the Admin Portal home, or from the Admin Portal back toward the main dashboard when that is the correct parent. Using Back keeps you inside supported navigation flows. The browser’s own Back button can still move through history, but the in-app back button matches product intent and reduces surprises when you have opened several tools in sequence.

Role-Based Navigation​

What you can open depends on your role and tenant type.

  • Admin — You see tenant-scoped management: users, permissions, infrastructure where licensed, audit and notifications, site customization, support requests, events, and cost management as enabled for your subscription. You do not see SuperUser-only platform tools unless your account is elevated.
  • SuperUser — You retain tenant administration where applicable and additionally see platform-wide destinations (for example global tenant operations, catalog and features, invitations, and global customization). Your SuperUser badge uses the secondary styling in the header so elevated sessions are visually distinct.
  • Developer tenant users — When the product applies developer subscription rules, you may be redirected toward Subscription Management or related flows so plan state stays valid before you change other settings. Follow those redirects before expecting full admin pages to load.

Mobile Navigation​

On smaller screens, the header condenses. Secondary actions may move into an overflow menu so the bar stays usable on touch devices. Controls remain touch-friendly, with adequate spacing for taps. If you do not see an action inline, open the menu icon in the header region to reveal the same actions you would get on desktop, adapted for narrow viewports.

Help System​

A floating help control sits at the bottom-right of the interface (a FAB-style button). Use it to open contextual help for the area you are viewing, search across help topics, and discover related content without leaving your task. When you need narrative guides or reference material outside the app, the public site at Booga Enterprise Docs complements what you see in the overlay.

Theme Switching​

You can switch between light and dark themes from the header without navigating away from admin tasks. Pick the theme that matches your environment and accessibility preferences; the choice applies across the Admin Portal experience consistently with the rest of the signed-in product.

Best Practices​

  • Prefer the in-app back button over the browser Back button when you want to move to the parent screen the product expects—especially after opening several admin pages in one session.
  • Bookmark frequently used Admin Portal sections in your browser if your workflow repeatedly returns to the same management area (for example User Management or Audit & Compliance).
  • Log out when you finish sensitive administration, particularly on shared workstations, so sessions and elevated roles (SuperUser) are not left active.
  • Keep subscription and permissions reality in mind: if a section is missing, verify your role, your plan, and whether your tenant type routes you through subscription steps first.

Following these patterns makes Admin Portal work predictable: you enter from the main dashboard, branch to a page for each concern, step back with confidence, and lean on help and documentation when you need more detail.

⏱️ Read time: 6 minutes | 📊 Difficulty: beginner