Audit Log

Activity log: filters, field diffs, CSV export, load more. Pro · Account and access › Permissions, privacy and support

Installation

npx valyro-cli@latest login
npx valyro-cli@latest add audit-log

npm install valyro-ui-pro

import 'valyro-ui-pro/styles.css';
import { AuditLog } from 'valyro-ui-pro';

Props

Prop	Type	Default
`events` *	`AuditEvent[]`		Newest first.
`actions`	`Record<string, AuditActionMeta>`	`{}`	Readable names and tones per action. Unknown actions show their machine name.
`filter`	`AuditFilter`		Controlled `filter`; use with `onFilterChange`.
`defaultFilter`	`AuditFilter`		Initial `filter` when uncontrolled.
`onFilterChange`	`(filter: AuditFilter) => void`		Called with the new `filter` when it changes.
`manualFiltering`	`boolean`	`false`	The server filters: `events` are shown as given and `onFilterChange` should refetch.
`hasMore`	`boolean`	`false`	More (older) events can be loaded.
`loadingMore`	`boolean`	`false`	An `onLoadMore` request is in flight: shows a spinner at the end and holds off further loads.
`onLoadMore`	`() => void`		Called when the end of the list scrolls into view, or from the "Load older events" button.
`onExport`	`(events: AuditEvent[]) => void`		Replaces the built-in CSV download; receives the events matching the current filter.
`exportFileName`	`string`		File name of the built-in CSV download.
`loading`	`boolean`	`false`	Initial skeleton instead of rows.
`toolbar`	`ReactNode`		Extra controls at the end of the toolbar.
`expandedIds`	`string[]`		Ids of the events shown expanded, with their details and field changes.
`defaultExpandedIds`	`string[]`		Initial `expandedIds` when uncontrolled.
`onExpandedIdsChange`	`(ids: string[]) => void`		Called with the new `expandedIds` when it changes.
`locale`	`string`		Date, time and number formatting. Defaults to the `ThemeProvider` locale, then the browser's.
`headingLevel`	`2 \| 3 \| 4 \| 5 \| 6`	`3`	Level of the day headings, to fit the page's heading outline. Default 3.
`labels`	`Partial<AuditLogLabels>`		Overrides for the built-in English text; keys left out keep their defaults.

Related components

Permission Matrix — Roles and permissions matrix: inheritance, locks, bulk toggles, draft changes
Privacy Center — Privacy center: score, setting groups, protection counters
Support Center — Support: contact channels with status, tickets with filters
Two Factor Setup — Two-factor setup: method, QR code or phone, code verification
Active Sessions — Active sessions: current device, suspicious sign-ins, revoke access
Access Tokens — Personal access tokens: scope, last used, revoke
Age Gate — Age verification: date of birth, remember me, deny under the limit
Profile Details — Profile: completeness, verified contacts, fields
Address Book — Address book: home, work, default addresses and actions
Social Profiles — Linked social profiles: reorder, verify, copy link
Settings Panel — Settings page: section navigation, unsaved-changes bar, danger zone

Previous: Permission Matrix · Next: Privacy Center · All Account and access