Reading list Switch to dark mode

    Guide of Blacklist Customer for Magento 2

    Updated 11 January 2024

    Blacklist Customer for Magento 2 module offers the store admin excellent functionality to manage the customer profiles who had purchased from their store.

    Magento 2 Enhanced Customer Profile helps the store admin manage unwanted customer purchases.

    The business merchants can now restrict the purchase of a customer based on excessive returns, poor ratings, bad feedback, bad purchase history, etc.

    The store merchants can provide reviews and feedback for the customers based on the purchase. They can even block or unblock the purchase of a customer.

    Note: The module works only for registered users. It will not work for guest users.

    Start your headless eCommerce
    Find out More

    Check a brief overview of the plugin –



    • The store admin can add the order ratings per order wise.
    • The admin can add feedback and also review the customer.
    • There is a feature to block the customer from the admin end.
    • The admin can mention the reason for blocking the customer.
    • The store admin can restrict the customer from further purchases.
    • Similarly, the admin can set the rating visibility.
    • In the case of poor ratings, the admin can set auto block the particular customer profile for further purchases.
    • The admin can set the average ratings to auto-block the customer purchase.
    • The store admin can set the incremental auto-unblock for every blocked customer.
    • The customers can request the store admin for unblocking.
    • The store owners can set the duration of unblocking the customer profile.
    • The customer will receive emails for the purchase blocking and unblock request acceptance or denial.
    • Likewise, the store owner will receive an email whenever the customer requests to unblock.
    • The extension also supports GraphQL APIs.
    • The extension is fully compatible with the Hyva Theme.

    Install Extension from Webkul Store

    The installation is quite simple just like the standard Magento 2 extensions.

    #1 Download Module

    Firstly, you need to log in to Webkul Store, go to My Account>My Purchased Products section, verify and then download and extract the contents of this zip folder on the system.

    #2 Upload Folder

    Once the module zip is extracted, follow path src>app and then copy the app folder into the Adobe Commerce Cloud root directory on the server as shown below:


    #3 Run Commands

    After uploading the module folder, you need to run the following commands in the Magento 2 root directory:

    • php bin/magento setup:upgrade
    • php bin/magento setup:di:compile
    • php bin/magento setup:static-content:deploy
    • php bin/magento indexer:reindex
    • php bin/magento cache:flush

    Admin Configuration – Blacklist Customer for Magento 2

    The admin can configure the general module settings as shown below in the screenshot:

    General Settings

    Display Ratings On Customer- The store admin can set the ratings whether he wants to display them on the customer profile or not.

    Admin Email-id- Here, the store admin will enter the email address used in the email template and the places where the admin email is required.

    Blocked Purchased Comment- The blocked purchase comment will be entered by the admin that will display in place of add to cart for blocked customers.

    Duration Between Unblock Request- Enter the time in days which will display at the customer end from creating another unblock request.


    Auto Block Customer Purchase- The store admin can enable the Autoblock customer purchase for the customer in case of poor ratings. That will restrict the customer from further purchases.

    Average Rating- The admin can set the average rating for auto-block. The customer will be auto blocked If the average rating goes below.

    Auto Unblock Customer Purchase- The store owner can set auto to unblock for the customer purchase and the customer will be eligible for further purchase after some time.

    Initial Auto-Unblock- Here, the store owner can mention the duration in days after which the customer purchase will automatically unblock.

    Incremental Auto-Unblock- From here, the store admin can select Yes if he wants to set the incremental auto-unblock.

    Incremental Unblock Duration- Enter the duration of incremental unblock.


    Customer Profile Transactional Emails

    Unblock Purchase Mail to Customer- The store owner can configure the email for unblocking purchase mail for the customer.

    Block Purchase Mail to Customer- The customer will receive an email whenever the admin blocks the purchase.

    Request for Purchase Unblock Mail to Admin- The admin will receive an email if the customer’s request for the purchase unblocks.

    Request Denied Mail to Customer- The customer will receive an email if the admin denies the unblock request.


    The store owner can set the email template from Marketing>Email Template> Add New Template as shown in the screenshot.


    Now by navigating through Customer Profile>Customer Ratings the store admin view, and set the customer ratings.


    Here, the records for ratings will display to the store admin with rating, customer name, purchase status, blocked times, and last blocked to date.


    Block Customer Purchase

    When the admin clicks on the customer name, the customer information page will appear. The store owner can manage the ratings and Purchase block, and unblock from here.


    The average rating and order rating history will also display here.


    To block a customer’s purchase, the admin will click on the Block Purchase button present at the top in the Ratings option.

    A page will appear as shown in the below image:


    Furthermore, the admin has to fill in the block details. Here, the admin will select the reason for blocking the customer.

    After that, the admin can also add a note and then click on the Save button.


    The customer will receive an email whenever the admin blocks the purchase.


    When the customer’s purchase is blocked the customer will not be able to purchase from the store.

    Add Customer Rating

    Similarly, The admin can provide a rating to the customer by clicking on Add Rating button present in the Rating option in customer information.

    Order-rating-addition-Magento 2 Customer Profile

    A page will open to fill in the rating details. The admin has to select the ratings, order id, add a summary and description.

    Furthermore, The unblock requests will display to the admin in the Unblock Requests option in the Customer Profile.

    The customer name, unblock note, request date and action will display here.


    Moreover, the admin can unblock the purchase of a customer from Ratings option present in the customer information.


    The admin can view, unblock or deny the user request by clicking on the View button present in the Unblock Request section.


    The order rating history, previous blocks, customer account information, unblock notes will display on this page. At the top-right two buttons Accept Request and Deny will be visible to the admin.


    The admin can accept the unblock or deny the request of the customer as per the previous block and order history.

    The customer will receive an email if the store admin accepts the unblock request as shown below:

    email-purchase unblock

    Likewise, the customer will receive an email when the store admin will deny the customer’s request.


    Customer Profile View When Purchase Blocked

    In the customer’s profile, the customer will navigate through the My Account>My Rating section.


    The users can view their average profile rating in the My Ratings option. Here a note will display below average profile rating.

    Right below the note, a button for request unblock will display to the user. The users can request the admin to unblock their purchase by clicking on this button.

    Customer-profile-rating-Blacklist customer for Magento 2

    When the customer clicks on the button to request, a pop-up to add a note will open. The customer can add a note for the admin to unblock the purchase.

    Unblock Request Note-Blacklist Customer for Magento 2

    The admin will receive an email for the unblock request as shown in the image:

    admin-unblock-req-new-Blacklist Customer for Magento 2

    In case the admin did not approve the purchase unblock request then there a button will appear named Request Denied with a note.

    The customer can create another request after the duration set by the admin.

    m2-customer-profile-14-Blacklist Customer for Magento 2

    The customer will also not be able to purchase the items added to the wishlist as shown below:

    m2-customer-profile-13-Blacklist Customer for Magento 2

    The customers can also view their order rating history option in their profile.

    m2-customer-profile-11Blacklist Customer for Magento 2

    Front-End View – Blacklist Customer for Magento 2

    The blocked purchase will reflect in the product category option as shown in the screenshot:

    Block-purchase-on-category-Blacklist Customer for Magento 2

    When the customer tries to purchase the item then there is a message for Purchase Blocked will display at the place of add to cart button.

    Block-purchase-on-product-Blacklist Customer for Magento 2

    Note: If there is any previously added item in the cart and the customer’s purchase is blocked then the customer will not be able to purchase it when he proceeds to checkout.

    m2-customer-profile-12-Blacklist Customer for Magento 2

    That’s all in Blacklist Customer for Magento 2. Still, have any issues, feel free to add a ticket and let us know your views at

    Current Product Version - 5.0.4

    Supported Framework Version - 2.0.x , 2.1.x, 2.2.x, 2.3.x, 2.4.x

    . . .

    Leave a Comment

    Your email address will not be published. Required fields are marked*

    Be the first to comment.

    Back to Top

    Message Sent!

    If you have more details or questions, you can reply to the received confirmation email.

    Back to Home

    Table of Content