Help

Troubleshooting

Common registration, editor, persistence, template, and caching problems.

#Definition does not appear

  • Confirm the plugin is active.
  • Register on voxycure/register, not after init.
  • Use a unique sanitized slug or block ID.
  • Ensure the target post type exists and show_in_rest is enabled.

#Field does not save

  • Confirm field_key is present and stable.
  • Check the browser REST response for schema errors.
  • Verify the current user can edit that post or manage that option page.
  • For option tabs, ensure the field tab matches a tab value.

#Block template warning

  • Use an absolute path such as get_theme_file_path().
  • The file must exist, end in .php, and be under an approved root.
  • Do not pass a public URL as the template path.

#New URLs return 404

Deactivate and reactivate the plugin once, or visit Settings → Permalinks. Never flush rewrite rules on every request.

Framework version2.0.0
PHP requirement8.0+
Documentation updatedAugust 2026