UI, Personas & Customization¶

For end users this is a visual and navigational refresh. For anyone who forks the UI, writes a UI plugin, or maintains Playwright/Cypress suites, it is a large refactor.

The Explore page changes are documented separately in Discovery & Search.

Design system consolidation¶

Breaking for forks and plugins · Cosmetic for end users

1.13 carried a transitional set of MUI* wrapper components inside openmetadata-ui. 2.0 removes them and standardises on the shared @openmetadata/ui-core-components package (Untitled UI v8 naming: components/base/* and components/application/*).

Removed component modules¶

components/common/MUISelect/                 components/common/MUITextField/
components/common/MUIUserTeamSelect/         components/common/MUIDomainSelect/
components/common/MUIFormItemLabel/          components/common/MUIGlossaryTagSuggestion/
components/common/MUIAsyncTreeSelect/**      components/common/MuiDatePickerMenu/
components/common/MuiDrawer/                 components/common/ColorPicker/MUIColorPicker.tsx
components/common/IconPicker/MUIIconPicker.tsx
components/common/CoverImageUpload/MUICoverImageUpload.tsx
components/common/FileUpload/MUIFileUpload.tsx
components/common/DeleteModal/DeleteModalMUI.tsx
components/form/MUIAutocomplete/
components/common/atoms/asyncTreeSelect/**   components/common/atoms/navigation/useSearch.tsx
components/common/atoms/navigation/useBreadcrumbs.tsx
components/common/atoms/navigation/useViewToggle.tsx
components/common/atoms/pagination/usePaginationControls.tsx
components/common/atoms/notifications/NotificationMessage.tsx
components/common/atoms/table/TagsCell.tsx
components/common/atoms/data/useQueryBuilder.tsx

The SELECT_MUI field type is removed from the form builder.

Other removed UI modules¶

Generated model files for the removed Collate AI agent configs are deleted too.

New extension points¶

— these are the supported way to customise in 2.0.

App Mode¶

New concept · Affects: login experience and persona config

2.0 introduces two application experiences — Classic (the standard OpenMetadata UI) and AI (the assistant-driven experience, which requires the AI plugin, e.g. Collate).

Resolution order, highest priority first:

1. User preference — appModePreference in the user's preferences bag
2. Persona appMode — classic | AI (default classic), forced on login
3. Tenant defaultAppMode — the appConfiguration setting (ai | classic | null)

{ "type": "appMode", "config": { "value": "ai" | "classic" | null } }

The active mode is held in a single source of truth backed by a sessionStorage tuple, so sibling tabs no longer lose the active mode.

Per-user preferences API¶

New API, backed by a new user_preferences table

GET    /v1/users/{userId}/preferences
PUT    /v1/users/{userId}/preferences/{type}
DELETE /v1/users/{userId}/preferences/{type}

{
  "userId": "…",
  "preferences": [ { "type": "appMode", "config": { "value": "classic" } } ],
  "updatedAt": 1712345678000
}

The preferences bag is a typed discriminated union keyed by type. It is deliberately not a full entity — no versioning, audit or soft-delete — and is cascade-deleted via UserRepository#postDelete rather than a foreign key.

Personas gain AI context¶

· Collate AI features

persona.json and createPersona.json gain contextDefinition (type/personaContextDefinition.json) — "rules and settings used to materialize the shared AI context for this persona." New endpoints:

GET  /v1/personas/search                       # server-side persona search
GET  /v1/personas/me/context
GET  /v1/personas/{id}/context
GET  /v1/personas/name/{fqn}/context
GET  /v1/personas/{id}/aiContext
PUT  /v1/personas/{id}/aiContext
GET  /v1/personas/{id}/aiContext/document
POST /v1/personas/{id}/aiContext/document:refresh
POST /v1/personas/{id}/aiContext/rules
POST /v1/personas/{id}/aiContext/rules/preview
PUT  /v1/personas/{id}/aiContext/rules/{ruleId}
DELETE /v1/personas/{id}/aiContext/rules/{ruleId}

Supporting schemas: type/aiContext.json, type/personaContext.json, type/personaContextDefinition.json. A general /v1/ai/context/find and /v1/ai/context/attachedKnowledge are also added.

Context Center & Knowledge Center¶

Route replacement · Affects: navigation, bookmarks, reverse proxies, and internal documentation

Knowledge Center is removed as a standalone section. Existing pages are migrated automatically to Articles in Context Center, but hard-coded /knowledge-center/... URLs do not redirect and must be updated.

New Context Center UI routes:

/context-center
/context-center/dashboard    /context-center/articles     /context-center/documents
/context-center/filter       /context-center/memories     /context-center/integrations
/context-center/archive

New REST namespaces: /v1/contextCenter/pages, /v1/contextCenter/memories, /v1/contextCenter/drive/files, /v1/contextCenter/drive/folders, and /v1/attachments.

New entities: page, article, quickLink, pageHierarchy, folder, contextFile, contextFileContent, contextMemory, asset.

Visual and navigation changes¶

· Affects: end users, screenshots in your internal docs, E2E tests

Performance refactor (fork-visible)¶

· Affects: forks with deep imports

2.0 does a large code-splitting and lazy-loading pass:

• Pure utility functions are extracted out of large modules into *PureUtils files (ExplorePureUtils, AdvancedSearchPureUtils, QueryBuilderPureUtils, TablePureUtils, TagsPureUtils, EntityLineagePureUtils, DataProductPureUtils, DataInsightPureUtils, DataQualityPureUtils, FeedUtilsPure, EntityBreadcrumbPureUtils, …).
• utils/CommonUtils.tsx and utils/EntityUtils.tsx are deleted; facade imports are migrated to direct sources.
• CustomizePageUtils.ts splits into three focused modules.
• Settings, Entity and Entity-Import routers, tab-level components and heavy components are lazy-loaded behind withSuspenseFallback.
• Vite config is reworked for code splitting and chunk loading.

Storybook & component library¶

openmetadata-ui-core-components gains Breadcrumbs, EmptyPlaceholder, ProgressSteps, Toast, an Untitled UI v8 FilterBar, an xs button size, and a nightly Storybook Docker build.

Two renames to be aware of when consuming the package:

• Untitled UI v8 "safe class renames" applied across components.
• The Select-family placeholderIcon prop is renamed to icon.