Hooks and filters

Octa Editor exposes a small set of filters. All are optional. The defaults are safe.

Scope

Filter	Purpose
octa_editor_allowed_post_types	The post types Octa Editor operates on across every surface.
octa_editor_allowed_taxonomies	The taxonomies Octa Editor operates on across every surface.
octa_editor_known_document_keys	Extend the set of recognised top-level document keys.

Bulk import

Filter	Purpose
octa_editor_bulk_cap	The capability required to open the Tools → Octa Editor panel (Export, Import and Guide tabs). Defaults to edit_posts.
octa_editor_bulk_limits	Upload limits. Defaults to max_files 50 and max_bytes 2 MB.
octa_editor_bulk_post_types	The post types the bulk importer accepts.
octa_editor_bulk_taxonomies	The taxonomies the bulk importer accepts.
octa_editor_server_limits	The server limits the import plans against (upload_max, post_max, max_file_uploads, max_execution_time, memory_limit). Use it when a proxy is stricter than PHP: the upload cap is the lowest of the plugin cap, upload_max and post_max, and the save step budget follows max_execution_time.
octa_editor_import_step_seconds	How long one step of the content import save may run. Defaults to a third of the request time limit (PHP’s own, or max_execution_time from octa_editor_server_limits when a proxy is stricter), between 3 and 20 seconds.
octa_editor_export_unchecked_types	Types listed last and left unticked in the content export, as kind:type values. Defaults to post:octa_form.
octa_editor_reference_exists	The oracle a dry-run uses to decide whether a referenced record exists.

Providers

Filter	Purpose
octa_editor_fields_provider	Replace the custom-fields adapter (ACF by default).
octa_editor_seo_provider	Replace the SEO adapter (Yoast or Rank Math by default).

Abilities

Filter	Purpose
octa_editor_ability_mcp_public	Control which abilities are MCP-public. Use it to enable octa-editor/save-document, which is off by default.

Updates

Filter	Purpose
octa_editor_update_repository	Override the update repository.
octa_editor_update_branch	Override the update branch.
octa_editor_update_token	Override the update token.

Example

Raise the bulk upload limit.

add_filter( 'octa_editor_bulk_limits', function ( $limits ) {
  $limits['max_files'] = 100;
  return $limits;
} );