Mobbiz Apps Documentation
📄 Documentation
📘 Mobbiz Apps Documentation — Admin Space & End User Workspace Guide

Mobbiz Apps Documentation

Comprehensive guide covering the Admin Space and End User Workspace — roles, configuration, workflow, and day-to-day usage.

User Types & Access Matrix

Mobbiz uses different user types to control which modules each person can access. Each user type has a defined access scope across Admin Space and Workspace.

User TypeUsersGroupsBusiness ProcessesData TablesDashboardsPortalsPluginsAudit LogsWorkspace
Admin
Users Manager
BA
End User
BPM Manager
Note: This matrix defines module access only, not detailed CRUD permissions. End User Workspace is available only to End Users. BPM Manager has the broadest access across all modules.

Admin Space

Users with Admin, Users Manager, and BA user profiles can access the Admin space by clicking the Admin icon in the upper right corner of the screen. End users cannot see this icon.

The following sections are available within the Admin space:

👥
Users

Manage company users — view, create, edit, deactivate, and delete.

🗂️
Groups

Organize users into groups for bulk role assignment to Business Processes.

⚙️
Business Processes

Configure forms, workflows, roles, permissions, SLAs, and PDF templates.

📊
Data Tables

Create and manage structured data tables used as reference sources.

📈
Dashboards

Build analytics dashboards with aggregation fields, tables, and charts.

🚪
Portals

Create external-facing portals with custom permissions and branding.

🔌
Plugins

Install and manage integrations and automation plugins company-wide.

📋
Audit Logs

Track all system changes — who did what and when.

Users

On the Users tab, Admins and Users Managers can manage company users — viewing, creating, editing, and deleting them.

Users List

The table displays: Name, Email, Phone, Employee ID, Profile, Status, plus any custom fields added by the Admin.

A search bar and filters (Active/Inactive, Profile) appear above the table. Click +More to add filters by custom fields (the field must have Searchable enabled).

Add / Edit User Form

Basic fields: Status (Is Active toggle), Email Address, First Name, Last Name, Phone, Employee ID, Profile (mandatory).

Login requirement: At least one of Email, Phone, or Employee ID must be filled — these are used as login credentials.

Custom Fields

Admins can add custom fields via the 3-dot menu → + Add custom field. Supported types include String, Number, Date, Time, Timestamp, Email, Phone, Selection, File Upload, URL, Switch, Signature, Geolocation, Reference, Look-up, and Autopopulated.

Custom Field Parameters

ParameterDescription
PermissionsHidden (Admin only), Private (Admin + owner), or Public (all authorized users). Mandatory setting.
MandatoryIf enabled, the user form cannot be saved without a value.
SearchableEnables searching/filtering by this field in the user list. Also required for use in constraints and smart filters.

CRUD Operations

  • Create: Click Add User, fill required fields (Profile + at least one of Email/Phone/Employee ID), click Add.
  • Bulk Create/Update: 3-dot menu → Upload/Add Records → download template → fill → upload CSV.
  • Edit: Click a row in the user table to open the Edit User form.
  • Deactivate: Toggle the Is Active switch. Deactivated users lose login access.
  • Delete: Open Edit form → click Delete → confirm. Deleted users cannot be restored via the UI.

Groups

Groups allow BAs to assign multiple users to Business Process roles at once, instead of adding users one by one.

Managing Groups

  • Click + Add new group → enter name → Create.
  • Select a group to view/edit its name, description, and user list.
  • Add users: Click Add User → select from dropdown → Add → Save.
  • Remove users: Click the delete icon next to a user → Save to confirm.
  • Delete group: Click Delete. This revokes group access from all related Business Processes.
Warning: Deleting a group removes it from all Business Processes and revokes all associated user access immediately.

Business Processes

The Business Processes tab is the core configuration area for forms, workflows, roles, and permissions.

Creating a BP

  1. Click + Add Business Process.
  2. Enter a unique Name (required) and Abbreviation (1–4 chars, letters + digits, not digits-only).
  3. Click Create. The General tab opens automatically.

General Tab Settings

FieldDescription
Business ProcessUnique name (required)
AbbreviationURN prefix for all documents in this BP (required, unique)
DescriptionWritten summary of what the BP is for
Icon64×64 px image representing the BP
Cover ImageBanner displayed above each document (recommended: 1700×200 px)
ActiveToggle to show/hide BP in Workspace. Inactive BPs hide all documents.
Enable Public FormMakes BP accessible to unauthenticated users via a public link or QR code

BP Configuration Menu

Each BP has the following sections: General, Form Builder, Workflow, Roles, Permissions, Config, Standard Reference Display, Cards, SLAs, PDF Templates, Plugins, Progress Indicator, Archiving Documents, Duplicate Checker.

Form Builder

The Form Builder allows BAs to design document layouts by adding and configuring Sections and Fields. Changes must be Saved and then Published to take effect in live documents.

Change Indicators

🟢 Green dot

New fields added (not yet saved)

🟠 Orange dot

Fields edited / layout changed

🔴 Red dot

Fields with incomplete/invalid config

⚫ Gray dot

Fields deleted

Field Types

Field TypeDescription
StringSingle-line or paragraph text. Supports min/max chars, alignment, format, QR input, validation.
NumberNumeric input with min/max, decimal precision, comma separator, percentage.
DateDate picker with range restrictions and weekend exclusion.
TimeTime input with optional default value.
TimestampAuto-records exact date and time.
Date/Time RangeDefines a period between two dates or timestamps.
EmailEmail input with optional verification (None / Enabled / Required).
PhonePhone number with country code, SMS verification, and QR input.
SelectionDropdown or checklist with predefined options, colors, sorting, multi-select.
File UploadSupports Any, Image (PNG/JPEG/SVG), or Document types. Camera input and PDF generation supported.
URLWeb address field with format validation.
SwitchOn/Off toggle with optional default value.
SignatureElectronic signature — draw or upload as image.
GeolocationCaptures latitude and longitude automatically.
Computation (fx)Calculated field using formulas with Number and Fx fields. Always read-only.
ReferenceLinks to a document, data table record, or user profile. Supports filters, groups, multi-select.
Look-upDisplays a field value from the selected Reference record (dynamic — updates if source changes).
AutopopulatedSame as Look-up but static — value is set at save time and does not auto-update.
Aggregation FieldAggregates values (Sum, Count, Avg, Min, Max) from source records.
Aggregation TableSummary analytics table with multiple columns and grouping.
Report TableDisplays source records in a table with custom columns and filters.
Embedded TableManual or dynamic data entry table within the form.
Reference TableShows records that link back to this document via a Reference field.
MultilineMultiple-row text input with configurable data type and row limits.
GapAdds blank spacing within the form layout.
Tip: Fields can be arranged 1–4 per row. Embedded Table and Reference Table always occupy a full row.

Workflow

The Workflow tab lets BAs configure the document lifecycle — statuses and the transitions between them.

Statuses

Every BP starts with a Draft status (cannot be deleted). BAs add additional statuses and mark them as end statuses:

  • Positive end status — highlighted green (e.g., Completed, Approved)
  • Negative end status — highlighted red (e.g., Rejected, Cancelled)

Dynamic Actions

Dynamic actions are buttons that transition a document from one status to another. Actions are created by clicking the cell at the intersection of the Origin and Destination statuses in the workflow table.

DirectionIconDescription
Forward to group🟢Move to next status, assign to all role members
Forward to individual🟢Move to next status, user selects one assignee
Backward to group🔴Return to previous status, assign to all role members
Backward to individual🔴Return to previous status, user selects one assignee
Return to previous owner🔴Return to the user who last performed a dynamic action

Roles & Permissions

Roles

BAs assign user groups to BP roles to control who can access documents. Role access levels include:

  • Viewer — can only view documents
  • Editor — can create, view, and edit documents
  • No Access — cannot see documents

SLAs

SLAs measure how long a document remains in a specific status. Configuration options:

  • Task Assigned — timer starts when the document enters the status
  • Deadline — specific date/time after which the document is overdue
  • Warning threshold — amber indicator before the SLA turns red
  • Additional Settings — restrict counted days (e.g., weekdays only) and hours (e.g., 9am–5pm)

Data Tables

Data Tables store structured data that Business Processes can reference. They are organized in folders in the left lateral menu.

Key Features

  • All field types supported (same as Form Builder fields)
  • Permissions: Grant View or Edit/Add/Delete access per user or group
  • Unique Records: Enforce uniqueness on one or more columns
  • Group Records: Group rows by Reference column values (up to 5 levels)
  • Standard Reference Display: Configure default display when this DT is used as a Reference source

Dashboards

Dashboards visualize data from BPs and Data Tables using widgets. BAs create and configure dashboards; End Users can view them.

Widget Types

🔢 Aggregation Field

Displays a single calculated metric (Sum, Count, Avg, Min, Max). Occupies 1×1 grid.

📋 Aggregation Table

Summary table with multiple columns and grouping criteria. Spans full row width.

📊 Chart

Column, Bar, or Pie/Donut charts. Supports sorting, top/bottom N, cumulative, and label customization. Occupies 2×2 grid.

Dashboard Permissions

BAs can restrict dashboard visibility to specific users, groups, or all users via the dashboard configuration menu (Edit → View Dashboard field).

Portals

Portals provide a separate, customized interface for external or client-facing users, with overridden permissions and branding.

Portal Sections

  • Users — Add existing users or create portal-specific users
  • Business Process Permissions — Override field/status permissions (can only restrict further, never expand)
  • Configuration — Define accessible BPs and access constraints (field-based or generic)
  • Customizations — Rename labels, configure navigation, set landing page, mobile icons
Permission Rule: Portal permissions are always restrictions on top of the main BP permissions. You cannot make a field more permissive in a portal than in the main BP.

Plugins

Plugins extend BP behavior through external integrations, automations, and webhooks. They can be installed at the BP level or company level.

Company-Level Plugin Sections

  • General — Plugin metadata, enable/disable switch, delete
  • Configuration — Triggers, field mapping, webhook URLs, skip duplicate option
  • Logs — Execution history with timestamps, duration, status (Started / Success / Error), and retry option
Note: Execution logs are only available at the company-level Plugins screen, not at the BP level.

Audit Logs

Audit Logs record all system changes — who changed what, and when. Accessible by Users Managers, BAs, and BPM Managers.

Filters

  • Category — Filter by area: Users, Groups, BusinessProcess, FormBuilder, Workflow, Roles, Data Table, Plugins, Automations, and more.
  • Sender — Filter by one or more specific users who performed actions.

Log Entry Columns

Date/Time · Type (Add / Update / Delete) · Category · Description · Sender


End User Workspace

This guide covers how End Users access and interact with the Mobbiz Workspace — authentication, document management, field behavior, notifications, and account settings.

Scope: This guide does not include workflow design, form configuration, or technical setup. It focuses on runtime usage.

Authentication & Access

Login URLs

  • Generic: https://cloud.mobbizapps.com/#/login
  • Company subdomain: Custom URL with company branding
  • Internal/Testing: https://cloud.internal.mobbizapps.com/#/login

Login Credentials

Users log in with: Email address, Phone number, or Employee ID — plus their Password.

Password Recovery

  1. Click Forgot Password? on the login screen.
  2. Enter your email address and click Submit.
  3. A reset link is sent from no-reply@mobbizapps.com.
  4. Click the link — your old password becomes invalid and you must set a new one.

Session & Security

  • Users are automatically logged out after 60 minutes of inactivity.
  • Mobbiz supports SSO (Okta, Keycloak) via a plugin-based framework.
  • Custom login branding (logo, theme colors) is configured by Admins via Company Settings → Company Colors.
Subdomain note: Company subdomains are set once at company creation and cannot be modified via the UI. Changing a subdomain breaks all previously shared public links.

New Document

End Users with edit rights on the Draft status of a BP can create new documents.

Two Ways to Create a Document

  • Upper navigation: Click the New button → select a Business Process → blank form opens.
  • Lateral menu: Click the (+) button next to a Business Process name.

Form Actions

  • Save (Static action) — saves the document without changing its status.
  • Assign — assigns the document to another user.
  • Dynamic actions — transition the document to the next status (buttons configured in the Workflow).

Bulk Document Creation

Users can upload multiple records at once via 3-dot menu → Upload/Add Records. Download a template, fill it in, save as CSV, and upload.

Delete Draft Documents

Draft documents can be deleted by users with the appropriate rights. Once a document moves past Draft status, deletion may be restricted based on Workflow configuration.

Lateral Menu

The left-side lateral menu provides navigation to all Business Processes the user has access to, as well as Data Tables and other workspace items.

  • Click a BP name to view its document list.
  • Click (+) next to a BP name to create a new document directly.
  • The menu can be collapsed to maximize the main workspace area.
  • Portal admins can customize which items appear and their order via Portal Customizations.

Tasks & Documents

The Tasks page shows documents assigned to or actionable by the current user. The Documents page shows all documents the user has access to across Business Processes.

SLA Status Indicators

  • 🟢 Green — within SLA time limit
  • 🟡 Amber — warning threshold exceeded
  • 🔴 Red — overdue (SLA exceeded)

Views

Users can switch between different view configurations (columns, filters, grouping) as configured by BAs. Views can be saved and reused.

Archived Documents

Archived documents are excluded from the main document list. To view them, apply the Workflow state filter on the Tasks page or a quick filter on the Documents page. Archived documents show their status name on a white background with a border.

Notifications

Mobbiz generates notifications for document assignments, status transitions, and other workflow events. Notifications appear in the notification panel accessible from the top navigation bar.

  • Click the notification icon to view your notification list.
  • Notifications link directly to the relevant document.
  • Notification rules are configured by BAs within the Business Process settings.

My Account

Users can manage their own profile via User Account (avatar) → Account Settings. Changes made here are reflected on the Admin Users page.

Account Settings Options

  • Update profile information (name, phone, etc.)
  • Change password
  • Upload or update personal signature
  • Manage notification preferences
  • Switch company (if the user has access to multiple companies)
  • Log out

Company Settings (Admin only)

Admins can configure company-wide settings via User Account → Company Settings, including:

  • Company name, logo, and branding colors
  • Login screen customization and public form buttons
  • Date/time format preferences
  • SSO configuration
Mobbiz Apps Documentation
© Mobbiz Apps. All rights reserved.