Guide

Academic Identity troubleshooting

Recurring failures when DOI schema or citations do not appear.

Guided diagnosis

Citation or JSON-LD missing?

Pick the symptom that matches what you see.
Question 1
Question 1

What is broken?

Schema.org JSON-LD not on the page

Cause: Stored datacite_doi is empty or invalid JSON.

Fix: Open Academic Identity, paste valid DataCite JSON, and save.

Citation appears twice

Cause: The block is in both post content and a template pattern. Stripping only runs for is_singular( 'post' ) when the block is inside core/post-content.

Fix: Keep the block in the template pattern only. On other post types, adjust placement or the strip condition in class-doi-citation.php if needed.

Citation missing on dataset taxonomy pages

Cause: Datacite::get_doi_citation() uses PRC\TDS\get_related_post() and returns early when Term Data Store has no related post.

Fix: Confirm the datasets term has a related post in Term Data Store.

Academic Identity sidebar missing

Cause: Enqueue skips when get_wp_admin_current_post_type() is empty or unexpected, or inspector assets were not built.

Fix: Confirm prc-platform-core returns the current post type, then rebuild:

npx turbo build --filter=@prc/schema-academic-identity

Was this helpful?