Skip to content

Audit logs

For Owner, ManagerAll plans

Trace every sensitive action performed in your shop - who created an API key, who invited a new staff member, when shop settings were modified, or who created a new role - complete with timestamps, IP addresses, client devices, and exact before-and-after change diffs.

Owners, managers, and compliance auditors with the View audit logs (org.audit.view) and Export audit logs (org.audit.export) permissions.

  • You are signed in to the staff app with an Owner or Manager role.
  • Security-critical events (role modifications, API key creation, member invitations) are logged automatically; there is no setup or activation required.
  1. Open Audit logs

    Navigate to Settings → Audit logs (/settings/audit-logs) in the left sidebar, or press ⌘K (Ctrl+K) and type Audit logs.

    Audit logs: every sensitive change, who made it and when
    Audit logs: every sensitive change, who made it and when
  2. Filter by activity category

    Use the category pill buttons at the top of the feed to narrow down events:

    • All Activities: Complete chronological feed across the entire organisation.
    • Security & Auth: API keys, credentials, and authentication updates.
    • Team & Roles: Staff invitations, role assignments, and permission changes.
    • Settings & Billing: Organisation details, addresses, banking info, and subscription updates.
    • Pricing & Catalogue: Product pricing shifts and catalogue modifications.
    • Sales & Till: Cash register shifts, tenders, and till reconciliations.
    • Stock & Inventory: Stock adjustments, serial assignments, and branch transfers.
    Show screenshot
    Audit logs filtered to Security and Auth
    Audit logs filtered to Security and Auth
  3. Search and filter by actor or date range

    • Search query: Type into the search box to find events by action name (e.g. api_key.created), actor name or email, IP address, or target ID.
    • Time presets: Filter by All Time, Today, Last 7 Days, or Last 30 Days.
    • Actor dropdown: Select a specific team member to view all actions performed by that user. The actor list displays user photos and names.
  4. Inspect event details and state changes

    Click on any row or select the Inspect button on the right side of an entry to open the slide-over detail drawer:

    • Actor & Origin: View the user’s name, email, avatar photo, IP address, request ID, and browser/device User-Agent string.
    • Target Entity: See the affected model type (e.g. Role, Api_key, Member) and copy its unique identifier.
    • State Changes: Review a structured tabular diff comparing Before vs After values for all modified attributes.
    • Event Metadata & Raw JSON: Inspect raw request metadata and copy the complete JSON payload for external audits.
    Show screenshot
    Inspecting one audit entry: who, what changed and the raw record
    Inspecting one audit entry: who, what changed and the raw record
  5. Export audit log as CSV

    Click Export CSV in the header. The system streams an RFC 4180-compliant CSV download containing your active filtered view with UTF-8 BOM encoding for clean opening in Microsoft Excel and Google Sheets.

  6. Navigate pages

    Use the pagination bar at the bottom of the table to navigate backward and forward (Previous / Next), jump back to the first page, or change the page size (10, 25, 50, or 100 items per page).

  • Actions such as creating a new API key at /settings/api-keys or inviting a staff member at /team appear immediately in the audit feed.
  • Clicking Inspect displays the exact fields that changed without exposing sensitive credentials (passwords, auth tokens, and raw secrets are automatically redacted server-side).
  • Staff cannot access Audit logs: Ensure their assigned role includes the org.audit.view permission under Team → Roles. By default, Owners, Admins, and Tech Admins have audit access.
  • Export button disabled: The logged-in staff member needs org.audit.export to trigger CSV exports.
  • API keys - Generate secure machine tokens for third-party tools.
  • Custom roles - Tailor permissions for cashiers, accountants, and store supervisors.