Byline CMS
  • Inicio
  • Docs
  • Acerca de
Byline CMS
Ver en GitHub
  • Search & Document Extraction
  • Getting Started
    • Overview
    • CLI
    • Development environment and example application
    • Configuration
    • Upgrading from 3.21 to 4.x
    • Upgrading from 4.11 to 4.12
  • Why Byline
    • Overview
    • Mission & Vision
    • Content Management in the Time of AI
    • Byline for Collections
  • Key Architectural Decisions
    • Overview
    • Core Document Storage
    • Core Composition
    • Transactions
    • Path Grammar
    • Deployment Topologies
  • Collections
    • Overview
    • Fields
    • Blocks
    • Relationships
    • Document Trees
    • Document Paths
    • File / Media Uploads
    • Rich Text Editor
    • Collection Versioning
  • Reading & Delivery
    • Overview
    • Client SDK (@byline/client)
    • Routing & API
    • Transports
    • Markdown Export
    • MCP Server
    • Caching
  • Search
    • Overview
    • Configure search
    • Indexing and reindexing
    • Search API
    • Search provider contract
    • Portable multilingual search analysis
    • PostgreSQL and MySQL search providers
    • Attachment extraction for search
    • Native search engines and backend portability
    • Semantic discovery and institutional standards
  • Auth & Security
    • Overview
    • Authentication & Authorization
    • Auditability
  • Internationalization (i18n)
    • Overview
    • The host i18n system
    • Admin interface translations
    • Content locales
    • Administering content locales
  • Admin UI
    • Overview
    • UI Kit (@byline/ui)
    • Admin-config registration
    • Collection groups
  • API Reference
    • Overview
    • Configuration API
    • Collections API
    • Fields API
    • Client SDK API
  • Scheduling
    • Overview
    • Recurring tasks
    • Scheduled publication
  • Analytics
    • Overview
    • Analytics configuration
    • Analytics browser agent and consent
    • Analytics ingest and deployment
    • Analytics storage, rollups, and operations
  • Testing
  • Inicio

API Reference

Companions:

  • Configuration — an introductory tour of the application files and runtime boundaries behind these contracts.
  • Key architectural decisions — the design context for the APIs listed here.
  • Scheduling — the ServerConfig scheduling properties in context: recurring tasks, the ticker, and scheduled publication.
  • Testing — the unit, integration, and browser suites used to verify these contracts.

This section is the lookup surface for Byline's application-facing APIs. Use it when you know which system you are configuring and need the exact properties, defaults, parameters, return shapes, or runtime restrictions.

Core references

  • Configuration API documents BaseConfig, AdminConfig, ServerConfig, BylineCore, configuration registration, and server client getters.
  • Collections API documents CollectionDefinition, CollectionAdminConfig, BlockAdminConfig, workflow configuration, and lifecycle hooks.
  • Fields API documents the common field contract, all 22 built-in field kinds, default values, validation, hooks, and admin field overrides.
  • Client SDK API documents BylineClientConfig, BylineClient, every public CollectionHandle method, shared read and write options, and result envelopes.

Subsystem references

These existing documents remain the canonical references for their narrower contracts:

Surface

Canonical reference

Authentication, actors, abilities, and sessions

Authentication and authorization

Audit log and version attribution

Auditability

File and image uploads, UploadConfig, and upload hooks

File and media uploads

Relation fields, populate, and relation envelopes

Relationships

Rich-text editor and server adapters

Rich text

Document paths and slugifiers

Document paths

Document trees

Document trees

Search collection configuration

Search configuration

Search query API

Search API

SearchProvider implementation contract

Search provider contract

Admin and API route mounts

Routing and API

Interface and content locale configuration

Internationalization

Database adapter contract and boot composition

Core composition

Typed EAV storage and stored value shapes

Document storage

Reference conventions

  • A property without ? is required by TypeScript.
  • “Conditional” means the property is optional in the type but required when another configured feature uses it.
  • Defaults describe current runtime behavior when the property is omitted.
  • _-prefixed options are internal or trusted-tooling escape hatches, even when TypeScript exposes them for hook re-entry.
  • The implementation and exported TypeScript types remain authoritative when a reference and a locally installed package version differ.
AnteriorCollection groups
SiguienteConfiguration API

En esta página

  • Core references
  • Subsystem references
  • Reference conventions
Byline CMS

Construyendo el futuro de la gestión de contenidos, un commit a la vez.

Proyecto

  • Documentación
  • Hoja de ruta
  • Contribuir
  • Versiones

Comunidad

  • Discusiones en GitHub
  • Blog
  • Boletín

Avisos legales

  • Política de privacidad
  • Condiciones de uso
  • Cookies

© 2026 Infonomic Company Limited y colaboradores. Open source y hecho con ❤️ por la comunidad.