Guide

Art Direction troubleshooting

Recurring editor, frontend, social, and Distributor failures.

Art Direction panel not appearing

Symptom: Sidebar shows the default Featured image panel.

Cause: Inspector bundle not built/enqueued, or the post type lacks prc-art-direction support.

Fix: Run npx turbo build --filter=@prc/art-direction. Confirm add_post_type_support( $type, 'prc-art-direction' ) (or the enabled-types filter). Assets enqueue only for enabled post types.

Frontend ignores art direction

Symptom: core/post-featured-image shows the default featured image.

Cause: Empty artDirection meta and no featured-image fallback, or render path not active.

Fix: Save slots in the editor. Verify GET /wp-json/prc-api/v3/art-direction/get/{post_id}. Rebuild the plugin if the featured-image override is missing.

Social OG image stale

Symptom: Yoast still serves an old Open Graph / Twitter image.

Cause: Edge or Yoast page cache serving a previous HTML head.

Fix: Confirm the social slot in the REST response. Purge Yoast and CDN/edge caches for the post.

Distributor push loses images

Symptom: Destination site missing or broken art direction images.

Cause: Distributor inactive or too old for distributor_register_data().

Fix: Activate a current Distributor on source and destination. The plugin registers remapping only when that API exists.

Was this helpful?