Reviews
      Back to home
      1. Knowledge Base
      2. Apps
      3. Reviews

      Okendo Reviews

      Use Okendo with Nyla (only on Okendo Advanced plans and above)

      NOTE: Due to Okendo's policies, Okendo is only available to use on headless sites on their advanced plan and above. This means that you might need to upgrade your plan in order to continue using Okendo with Nyla.

      To get access to use Okendo with Nyla on their advanced plan, you may need to reach out to your Nyla Success manager, they can grant an exception with Okendo to enable the access you need on their power plan (as opposed to their top plan which you might get quoted by reaching out to them directly). 

      Activating Okendo reviews for Nyla

      In order to use Okendo with Nyla, you need to ask for Storefront Metafield access. Once this has been granted, to enable Storefront Metafield access you should connect the storefront metafield access by clicking on Settings > Advanced > Storefront Metafield Access - Connect 

      Activating the app:

      In order to activate the Okendo reviews app, you should go to Apps > Okendo and switch the app on.

      You need to enter your store hash on Nyla, which is called your User ID in Okendo. To find this: 

      1. Navigate to the integrations page in Okendo (Settings > Integrations)
      2. Copy the User ID
      3. Add to the Store Hash field in Nyla
      Once entered, make sure to save and publish your app after adding these settings. 

      Adding Okendo to your site: 

      To add the Okendo reviews widget below the fold: Use the Okendo Reviews v2 content item. This content item pulls in the reviews widget that has been styled in the Okendo app itself. To make updates to the look and feel of the widget you should do this within the Okendo app. Note that if you make these changes in your Okendo app during your Nyla onboarding, they may show up on your Shopify theme. 


      The data that is displayed in this widget is pulled directly from the Okendo app. If you are seeing reviews for your products not showing as expected, you should review your Okendo setup. 

      The reviews widget configured in Nyla needs to be within the relevant product source. To optimise site management and avoid issues, we suggest to use the page source for all reviews widgets and to have product pages configured using page source. 

       

      Reviews summary above the fold and in product listing pages: After you have enabled Storefront Metafield access you can use the Okendo Rating content item.

      If you have not enabled storefront metafield access, above the fold reviews for Okendo will show blank. 

      This content item pulls the reviews average and reviews count from Shopify metafields that are automatically populated by the Okendo app. The page on your site will show the value that was present in this metafield at the last time the page was built. 

      Nyla reads from metafields on this content item to optimise load time by reducing the data loaded when customers access the page. This is because it is important that product detail pages and product listing pages load above the fold as quickly as possible for the end user in order to optimise for key metrics such as conversion rate and average order value. 

       The flow for updating the value shown on your site is as follows: 

      1. Okendo app writes the review average and review count values to Shopify metafields
      2. Once the relevant page is built in Nyla then Nyla will update the value content item based on the current metafield value

      Nyla reads the data from the following locations: 

      • Nyla reads the reviews count and value from the okendo.ReviewsWidgetSnippet metafield in Shopify
      • If the previous metafield is not present, or doesn’t have a value, Nyla will read from the okendo.ProductListingSnippet
      • If all of the above metafields are empty, then the reviews count will show blank. Occasionally third party apps have issues or a delay in writing to metafields, so if you see the metafields above with blank or inaccurate values when it shouldn't be, you should reach out to Okendo to look into the issue. 

      Troubleshooting common Okendo issues

      Why are my above the fold reviews showing a different value than what I expect? 

      In order to use Okendo with Nyla, you need to ask for Storefront Metafield access. Before following troubleshooting instructions you should ensure you have completed this step.

      Nyla reads reviews data for the stars count and average above the fold and on collection pages from metafields.

      Sometimes apps have issues syncing to metafields. In some cases the update can be delayed or it might stop happening entirely due to issues on the third party app provider's end. 

      If you are seeing above the fold reviews not showing up you should: 

      • Make sure you have connected your metafields to the storefront API
      • Check the okendo.ReviewsWidgetSnippet metafield in Shopify
      • If the previous metafield is not present, or doesn’t have a value, check the okendo.ProductListingSnippet in Shopify 
      1. If those values are either empty, or don't match what you expect, you should reach out to the app provider to look into the issue on their end. 

      2. If those values are what you expect, then you should revalidate your page in Nyla or force a rebuild of your site. Once the build is complete, the values will show as you expect. 

       

      Why are my reviews below the fold different to my reviews above the fold? 

      In order to use Okendo with Nyla, you need to ask for Storefront Metafield access. Before following troubleshooting instructions you should ensure you have completed this step.

      Given that app providers sync data to metafields, this can occasionally take some time on their end, so you might see a lag between the value shown on their widget (which pulls directly from the app) and the reviews above the fold (which pulls from metafields). 

      If you are seeing above the fold showing differently to what you expect you should: 

      • Make sure you have connected your metafields to the storefront API
      • Check the okendo.ReviewsWidgetSnippet metafield in Shopify

      1. If those values are either empty, or don't match what you expect, you should reach out to the app provider to look into the issue on their end. 

      2. If those values are what you expect, then you should revalidate your page in Nyla or force a rebuild of your site. Once the build is complete, the values will show as you expect. 

       

      Why are my reviews below the fold not what I expect?

      Most issues in this case are due to the data source. Either: 

      • The data at the source is wrong (e.g there's an issue in your reviews app, or there's a misconfiguration in the reviews app)
      • The data source is referencing the wrong product (e.g you need to update the product source in Nyla to match the product data you intend to pull in)

      Check your Okendo app: Nyla pulls below the fold reviews data directly from the app. If the data in the app itself is wrong, then you should review your app setup or contact the app provider for support.  

      Check your Nyla configuration: Reviews widgets need to use the correct product source. This is so that Nyla pulls in the right data for the page. Make sure that the product source being referenced in your reviews widget is the one you expect.