Troubleshooting

404s on recipe pages

Visit Settings → Permalinks and click Save Changes to refresh rewrite rules. MisePress also auto-refreshes rewrites after plugin updates, so this is mainly relevant on first activation.

If the issue persists, confirm your hosting environment isn't serving cached HTML for the URL — clear your page cache and CDN.

Engagement settings do not appear

Ratings, reviews, recommendations, and videos live under MisePress → Settings → Account & Engagement. They are intentionally separated from layout settings.

Nutrition API key does not work

1. Open Settings → General.
2. Paste the FoodData Central key and Save Changes.
3. Click Test API connection — a green status appears on success.

If MISEPRESS_USDA_API_KEY is defined in wp-config.php, that constant takes priority over the saved option.

Imported text shows unicode artifacts (e.g. cru00eape)

Re-import using the current MisePress importer. The importer decodes escaped and bare unicode sequences, normalises whitespace, and recognises accented unit words like cuillère, càs, càc, tasse, and gousse.

Bricks elements are missing

• Confirm Bricks is active.
• Open MisePress → Settings → Modules and ensure Bricks Builder elements is enabled.
• In Bricks, refresh the structure panel — MisePress elements live in their own category.

Schema not showing

• Enable Settings → General → Schema.org JSON-LD.
• Test a single published recipe URL with Google's Rich Results Test.
• Some optimization plugins strip JSON-LD; whitelist application/ld+json if so.

Styling changes do not apply

• Prefer overriding --mp-* CSS variables in your theme (see CSS Variables).
• Then check Settings → Frontend Appearance.
• If a builder (Bricks/ACSS) is overriding output, scope your overrides to a higher-specificity selector or override the variables on :root.
• Clear page caches and any CSS minifier cache.

AJAX filters / search seem stuck

• Confirm admin-ajax.php is reachable (some security plugins block it).
• Open the browser console and re-run a filter — request URLs are logged.
• A second filter click cancels the prior in-flight request; this is intentional and prevents stale results.

Builder conflicts (Bricks / Gutenberg / classic)

MisePress templates target only its own misepress__* BEM classes and never style global selectors. If a builder visually overlaps, it usually means:

• The theme is double-wrapping single content.
• A page-builder template is being applied to a MisePress single — disable that mapping.
• An ACSS preset is rewriting --mp-* variables — see ACSS.

Cache conflicts

If updates to recipes don't appear on archive pages, purge your page cache plus any object-cache layer. MisePress uses transients for archive collections; deleting a transient prefixed with misepress_ clears that cache.

Shared / slow hosting tips

• Disable auto-calculate nutrition on save if every save times out.
• Use a smaller posts_per_page value on archives.
• Defer the search index rebuild during off-peak hours from Settings → Advanced.

Still stuck?

Run MisePress → System Health. The page surfaces PHP version, WP version, active modules, missing dependencies, rewrite-rule status, and writeable upload paths.