---
title: "Payload import paths"
description: "What to import from which @systhemaui/payload entry."
url: https://docs.systhema.app/next/reference/payload-imports
version: unreleased (main)
docs_index: https://docs.systhema.app/next/llms.txt
---

`@systhemaui/payload` splits its exports across a few entries. This page lists what each one carries. In `'use client'` files, use the client entries described on [Imports in 'use client' files](https://docs.systhema.app/next/payload/with-systhema.md#imports-in-use-client-files) instead.

## Server-side imports

```ts
// Config wrapper.
import { withSysthema } from '@systhemaui/payload/config'
// (also re-exported from the package root)
import { withSysthema } from '@systhemaui/payload'

// Plugin options + utilities.
import {
  systhemaPayloadPlugin,
  getSysthemaPayloadPluginOptions,
  setSysthemaPayloadPluginOptions,
  type SysthemaPayloadPluginOptions,
  type CustomBlock,
  type CustomBlockConverter,
  type EditorName,
} from '@systhemaui/payload'

// AI assistant config (options + resolved shapes).
import {
  getAiConfig,
  resolveAiConfig,
  type SysthemaAiOptions,
  type SysthemaAiTextOptions,
  type SysthemaAiTextModelEntry,
  type SysthemaAiImageOptions,
  type SysthemaAiImageModelEntry,
  type SysthemaAiComposeOptions,
  type SysthemaAiTextProvider,
  type SysthemaAiImageProvider,
  type AiConfig,
  type AiTextConfig,
  type AiTextModelResolved,
  type AiImageConfig,
  type AiImageModelResolved,
} from '@systhemaui/payload'

// Analytics config (options + resolved shape).
import {
  getAnalyticsConfig,
  resolveAnalyticsConfig,
  capabilitiesFor,
  AnalyticsProviderError,
  type SysthemaAnalyticsOptions,
  type AnalyticsProviderOptions,
  type AnalyticsCustomOptions,
  type CustomAnalyticsAdapter,
  type AnalyticsConfig,
} from '@systhemaui/payload'

// Cloudflare config type and edge purge (server-only).
import { autoPurgePaths, type SysthemaCloudflareOptions } from '@systhemaui/payload'

// Form-submission list columns and CSV export shaping.
import {
  DEFAULT_FORM_SUBMISSION_COLUMNS,
  type FormSubmissionColumnMatch,
  type SysthemaFormSubmissionColumn,
  type SysthemaFormSubmissionColumns,
  type SysthemaFormSubmissionExportOptions,
} from '@systhemaui/payload'

// Editors.
import {
  rootLexicalEditor,
  regionLexicalEditor,
  fragmentLexicalEditor,
  slotLexicalEditor,
  inlineLexicalEditor,
  emailLexicalEditor,
} from '@systhemaui/payload'

// Field helpers.
import {
  buttonGroupField,
  colorSelectField,
  drawerField,
  faIconPickerField,
  iconGroupField,
  iconPickerField,
  keyField,
  messageField,
  nestedSlugField,
  rangeField,
  slugField,
} from '@systhemaui/payload/fields'

// `richTextField` is NOT in `/fields` — import it from the package root:
import { richTextField } from '@systhemaui/payload'

// Blocks.
import {
  AccordionBlock,
  AvatarBlock,
  ButtonBlock,
  ButtonBlockFields,
  CardBlock,
  CarouselBlock,
  ChipBlock,
  ColumnsBlock,
  EmbedBlock,
  FeatureBlock,
  FormBlock,
  GalleryBlock,
  GoogleMapsBlock,
  HeroBackgroundBlock,
  HeroFeatureBlock,
  HeroSimpleBlock,
  IconBlock,
  NestedStackBlock,
  QuoteBlock,
  RichTextBlock,
  SectionBlock,
  StackBlock,
} from '@systhemaui/payload/blocks'

// Access control helpers.
import {
  addScopedFieldAccess,
  capabilityOrPublished,
  capabilityOrSelf,
  publicOrCapability,
  requireAnyCapability,
  requireAnyCapabilityField,
  requireCapability,
  requireCapabilityField,
  requireUpdateOrScoped,
} from '@systhemaui/payload'

// Cookie consent (server-side helpers).
import {
  resolveCookieConsentConfig,
  seedCookieConsentFromConfig,
} from '@systhemaui/payload'

// SEO title templating.
import {
  DEFAULT_TITLE_SEPARATOR,
  resolveSeoTitle,
  TITLE_SEPARATORS,
  type SeoDefaults,
  type TitleSeparatorKey,
} from '@systhemaui/payload'
```

## Where each group is documented

- `withSysthema()` and the plugin options: [withSysthema()](https://docs.systhema.app/next/payload/with-systhema.md#imports-in-use-client-files) and [Plugin options](https://docs.systhema.app/next/payload/plugin-options.md).
- AI assistant config: [AI configuration](https://docs.systhema.app/next/payload/ai/configuration.md).
- Analytics config: [Analytics reference](https://docs.systhema.app/next/payload/analytics/reference.md).
- Cloudflare config and edge purge: [Cloudflare reference](https://docs.systhema.app/next/payload/cloudflare/reference.md) and [Auto-purge](https://docs.systhema.app/next/payload/cloudflare/purging.md).
- Form-submission columns and export: [Submission columns](https://docs.systhema.app/next/payload/forms/submissions.md) and [Import and export](https://docs.systhema.app/next/payload/forms/import-export.md).
- Editors: [Editor tiers](https://docs.systhema.app/next/payload/editor/tiers.md).
- Field helpers: [Field helpers](https://docs.systhema.app/next/payload/editor/field-helpers.md).
- Blocks: [Block catalog](https://docs.systhema.app/next/payload/blocks.md).
- Access control helpers: [Access control](https://docs.systhema.app/next/payload/access-control.md).
- Cookie consent helpers: [Editing consent in Payload](https://docs.systhema.app/next/guides/cookie-consent/editor.md).
- SEO title templating: [SEO settings](https://docs.systhema.app/next/payload/content/seo.md).

## Related

- [Package entry points](https://docs.systhema.app/next/reference/package-exports.md)