{"id":15,"date":"2026-05-03T15:52:30","date_gmt":"2026-05-03T15:52:30","guid":{"rendered":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/troubleshooting\/"},"modified":"2026-05-03T15:52:30","modified_gmt":"2026-05-03T15:52:30","slug":"troubleshooting","status":"publish","type":"post","link":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/troubleshooting\/","title":{"rendered":"Troubleshooting"},"content":{"rendered":"\n<p class=\"is-lede\">Common issues and how to resolve them, in roughly the order they come up.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"license-failure\">License activation fails<\/h2>\n\n\n\n<p>If clicking <em>Activate<\/em> returns &#8220;Could not connect to license server&#8221;:<\/p>\n\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check your hosting allows outbound HTTPS to <code>v2.fasterthemes.com<\/code>. Some firewalled hosts block it.<\/li>\n<li>Verify the key \u2014 keys are case-sensitive and have no spaces.<\/li>\n<li>Make sure the key isn&#8217;t already active on another site (deactivate it there first).<\/li>\n<\/ul>\n\n\n\n\n<p>If none of that works, contact <a href=\"https:\/\/fasterthemes.com\/contact\" rel=\"noopener\" target=\"_blank\">support<\/a> with your domain and order number. We can manually activate from our end.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"block-missing\">Recipe Card Block doesn&#8217;t appear in the inserter<\/h2>\n\n\n\n<p>Three possible causes, in order of likelihood:<\/p>\n\n\n<!-- wp:list{\"ordered\":true} -->\n\n<ol class=\"wp-block-list\">\n<li><strong>The Pro plugin is deactivated.<\/strong> Check at <strong>Plugins<\/strong>.<\/li>\n<li><strong>You&#8217;re using the Classic Editor.<\/strong> The block requires Gutenberg. Either deactivate the Classic Editor plugin or open the post in the block editor.<\/li>\n<li><strong>Block JS failed to load.<\/strong> Check your browser console \u2014 usually a caching plugin issue. Clear the cache for <code>\/wp-content\/plugins\/food-recipes-pro\/<\/code>.<\/li>\n<\/ol>\n\n<!-- \/wp:post-content -->\n\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\" id=\"schema-warning\">Google Rich Results test shows warnings<\/h2>\n<!-- \/wp:heading -->\n\n<!-- wp:paragraph -->\n<p>Warnings (yellow, not red) are usually missing optional fields. Common ones:<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:list -->\n\n<ul class=\"wp-block-list\">\n<li><strong>Missing <code>author<\/code>:<\/strong> The block uses the post author by default. If your post has no author or you&#8217;re using a custom post type without authors, add an author.<\/li>\n<li><strong>Missing <code>aggregateRating<\/code>:<\/strong> Only appears when at least one visitor has rated the recipe. Once you have one rating, the field appears.<\/li>\n<li><strong>Missing <code>video<\/code>:<\/strong> Optional. The block doesn&#8217;t currently include a video field \u2014 coming in v1.1.<\/li>\n<\/ul>\n\n<!-- \/wp:list -->\n\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\" id=\"layout-broken\">Homepage layout looks broken after switching<\/h2>\n<!-- \/wp:heading -->\n\n<!-- wp:paragraph -->\n<p>Most often a caching issue:<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:list{\"ordered\":true} -->\n\n<ol class=\"wp-block-list\">\n<li>Clear your WordPress page cache (W3 Total Cache, WP Rocket, etc.).<\/li>\n<li>Clear your CDN cache (Cloudflare, BunnyCDN).<\/li>\n<li>Hard refresh the page in your browser (Cmd+Shift+R \/ Ctrl+F5).<\/li>\n<\/ol>\n\n<!-- \/wp:list -->\n\n<!-- wp:paragraph -->\n<p>If still broken, switch the layout in the Customizer back to Grid and forward again \u2014 this re-saves the option and re-enqueues stylesheets.<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\" id=\"white-screen\">White screen of death after activation<\/h2>\n<!-- \/wp:heading -->\n\n<!-- wp:paragraph -->\n<p>Almost always a PHP version mismatch. Food Recipes Pro requires PHP 8.0 or later. Check your hosting&#8217;s PHP version (usually under &#8220;PHP Settings&#8221; or &#8220;MultiPHP&#8221; in cPanel) and bump to 8.1 or 8.2.<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:paragraph -->\n<p>If your host is locked to PHP 7.x, contact us for the legacy build (PHP 7.4 compatible, but no longer receiving feature updates).<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:heading -->\n<h2 class=\"wp-block-heading\" id=\"getting-help\">Getting more help<\/h2>\n<!-- \/wp:heading -->\n\n<!-- wp:paragraph -->\n<p>If your issue isn&#8217;t here, or the fix didn&#8217;t work:<\/p>\n<!-- \/wp:paragraph -->\n\n<!-- wp:list -->\n\n<ul class=\"wp-block-list\">\n<li>With an active license: email <a href=\"mailto:support@fasterthemes.com\">support@fasterthemes.com<\/a> with your domain, order number, and a screenshot or error message. We typically respond within 24 hours on business days.<\/li>\n<li>Without a license (free theme only): post in the <a href=\"https:\/\/wordpress.org\/support\/theme\/food-recipes\/\" rel=\"noopener\" target=\"_blank\">WordPress.org support forum<\/a>. We monitor it and reply to most threads within a few days.<\/li>\n<\/ul>\n\n<!-- \/wp:list -->","protected":false},"excerpt":{"rendered":"<p>Common issues and how to resolve them, in roughly the order they come up.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[],"class_list":["post-15","post","type-post","status-publish","format-standard","hentry","category-reference"],"_links":{"self":[{"href":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/wp-json\/wp\/v2\/posts\/15","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/wp-json\/wp\/v2\/comments?post=15"}],"version-history":[{"count":0,"href":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/wp-json\/wp\/v2\/posts\/15\/revisions"}],"wp:attachment":[{"href":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/wp-json\/wp\/v2\/media?parent=15"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/wp-json\/wp\/v2\/categories?post=15"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/food-recipes-wordpress-theme\/wp-json\/wp\/v2\/tags?post=15"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}