This article explains how to install and uninstall Feefo Ratings & Reviews on to a Magento 2.x instance. For instructions on installing Feefo Ratings & Reviews using composer, see this FAQ.

The module allows a merchant using Magento 2.x to send their sales data automatically to Feefo. Feefo then sends a feedback request on the merchant's behalf to all their customers and collates and publishes all feedback resulting in a Feefo star rating and a full set of reviews that can be seen on both the Feefo and merchant's websites.

Magento 2.x typically has the following default order statuses however they can be customised and therefore a merchant's setup may mean that the order statuses are identified differently from those listed below:

  • Suspected Fraud
  • Processing
  • Pending Payment
  • Payment Review
  • Pending
  • On Hold
  • Complete
  • Closed
  • Cancelled

As Feefo will only retrieve orders once they have reached the order status of 'Complete', for the plugin to function correctly, the order status of 'Complete' must not be customised. 

The module supports four methods of integration:

  • A service reviews widget that floats over the web page and is visible at all times. The colour, size and position of this widget are configurable from the Feefo Hub under 'Marketing > Service Reviews Widget'.
  • A product star rating widget that's normally placed near to the purchasing button showing the star rating for just this product.
  • A product reviews widget located towards the bottom of the product page that lists only this product's reviews.
  • A product category level star rating widget that allows site visitors to easily compare the ratings of various products within the same category.


Follow these steps to install Feefo Ratings & Reviews to your website:

  1. Open your terminal window and change the current directory to your Magento 2.x installation directory.
  2. Create a directory app/code/Feefo/Reviews/and copy the module files to it.
    mkdir –p app/code/Feefo/Reviews
  3. Ensure that you have permissions to execute bin/magento file: 
    php bin/magento
  4. Enable the Feefo_Reviews module: 
    php bin/magento module:enable Feefo_Reviews --clear-static-content
  5. Execute the module’s installation scripts: 
    php bin/magento setup:upgrade
  6. Compile the module: 
    php bin/magento setup:di:compile
  7. Deploy the static content: 
    php bin/magento setup:static-content:deploy
  8. Flush the Magento 2.x cache: 
    php bin/magento cache:flush
  9. After logging in to the admin panel of your Magento 2.x instance you should now see a 'Feefo Ratings & Reviews' menu option under the 'Marketing' tab:zn7Y_m5XyfswxtEKL-GbDHVvZ6_IqR-Umw.png

  10. Click on it to start the module installation process. If you have multiple stores set up within your instance you will be asked to select which store you wish to add Feefo Ratings & Reviews to. 
  11. You will be presented with a registration form if you are a new customer or a login page if you already have a Feefo account for the website domain you are setting up. wvF0y6PPJTpB21_YdihUXTWzckSVVpd6Xw.png
  12. A series of steps will guide you through the configuration of your feedback request process through to the completion of the installation. 
  13. You can further configure the module post installation by selecting the Marketing > Feefo Ratings & Reviews tab where you can:
    • Enable/disable all methods of review integration.
    • Customise the placement of your product page and category level review integration.
    • Enable/disable the native Magento reviews system.


Follow these steps to disable Feefo Ratings & Reviews on your website. For instructions on uninstalling Feefo Ratings & Reviews using composer, see this FAQ:

  1. Within the admin panel of your Magento 2.x instance select Stores > Configuration.
  2. Select the appropriate Store View for which you are uninstalling the plugin.
  3. Select Catalog > Feefo Reviews.
  4. Click Uninstall Plugin Data.
  5. A confirmation message will be shown upon successful uninstallation.

To completely remove the plugin from your Magento 2.x instance:

  1. Open your terminal window and change the current directory to your Magento 2.x installation directory.
  2. Make sure that you have permissions to execute bin/magento file: 
    php bin/magento
  3. Disable the Feefo_Reviews module: 
    php bin/magento module:disable Feefo_Reviews --clear-static-content
  4. Compile the required classes of the module:  
    php bin/magento setup:di:compile
  5. Delete the app/code/Feefo directory.
  6. Delete the admin user with username 'feefo'.8JhW3t8D9hfd_kt6vZd2uqYWUSZofJeQcQ.png
  7. Delete records with paths "feefo/service/access_key", "feefo/service/user_id", "feefo/service/plugin_id", "feefo/widget/settings", "feefo/widget/snippets" from the "setup_module" and "core_config_data" table.
    DELETE FROM setup_module WHERE module LIKE ‘%feefo%’
    DELETE FROM core_config_data WHERE path LIKE ‘%feefo%’


If at any point you see the 'Something went wrong' page, please follow these steps to help you identify the cause of your issue:

  1. Open your terminal window and change the current directory to your Magento 2.x installation directory.
  2. Open a log file with debugging information. 
    vim var/log/debug.log
  3. Near the end of the file, you should find a log of the issue. If you are not able to resolve the issue based on the information in the log, please send a copy of it to our Support Team for further assistance (