Installation




Before installing the extension, please make sure to Backup your web directory and store database


You will require to install MageDelight Base Extension first. If it is not installed then please download it from https://www.magedelight.com/pub/extensions/magedelight-base.zip and unzip the package file into the root folder of your Magento 2 installation.

Root Directory is - "app/code/magedelight/#YourExtensionName#"

  • Unzip the extension package file into the root folder of your Magento 2 installation.
  • Connect to SSH console of your server:
    • Navigate to the root folder of your Magento 2 setup
    • Run command as per below sequence,

      php bin/magento setup:upgrade

      php bin/magento setup:di:compile

      php bin/magento setup:static-content:deploy

      php bin/magento cache:clean

  • log out from the backend and log in again


If you are using Magento 2.3 or later then you do not need to activate license. Extension will be activated with silent activation mechanism and does not require activation keys to be entered manually.   



Backend Configuration (Admin side)



FieldDescription
Enable AI Self Try-onsTurn the AI Self Try-Ons feature on or off for your store. Select Yes to enable or No to disable.
AI ProviderChoose the AI provider that will generate the try-on experience (e.g., Ayna).


FieldDescription
API KeyEnter your Ayna API key. This key is required to connect your store with the Ayna service.
API URLSpecify the Ayna API endpoint URL used to send and receive requests. Example: https://api.getayna...
API Timeout (seconds)Set the maximum time (in seconds) the system should wait for a response from the API before timing out. Example: 60.


FieldDescription
AI Try-on TitleTitle displayed for the AI Try-On section on the product page (e.g., See How this outfit looks on you?).
Garment Image TitleTitle for the garment or product image section within the try-on tool (e.g., You are trying below garment).
Model Image TitleTitle for the customer model image upload section (e.g., Upload Your Photograph).
Generated Result TitleTitle for the section displaying the final AI-generated try-on result (e.g., See how you look with this outfit).
Show View Full Size ButtonOption to enable or disable the “View Full Size” button for generated images.
View Full Size Button LabelText label for the button that allows customers to view the AI-generated image in full size (e.g., View Fullsize Picture).
View All Try-ons Button LabelText label for the button that links to the customer’s try-on history (e.g., View All Try-ons).
Watermark TextText that will appear as a watermark on AI-generated try-on images (e.g., This is a trial image).

Backend Functionality



  • To display the 'Try-On' image feature for a product, navigate to Catalog -> Product -> Add/Edit -> Images and Videos in the backend. Click on the image you want to use for try-on; a pop-up will appear, presenting image options as below.


  • Select the "Try-On Image" option for the desired product image. This enables customers to use the try-on functionality exclusively for products where this option has been selected.

The Try-On Images section in the Magento 2 Admin Panel (path: MageDelight → AI Self Tryons → Try-On Images) . The AI Self Try-On extension provides functionality for both customers (frontend) and store administrators (backend) to manage virtual try-on records.

  • On the Customer Dashboard, users can view their personal try-on history, enlarge AI-generated images, and delete their own try-on records.

  • On the Admin Panel, store managers can view all customer try-ons across the store, including uploaded photos, generated images, and have the authority to delete any record when required (e.g., for privacy requests or cleanup).

The Delete functionality plays a crucial role in maintaining data privacy, ensuring compliance, and providing user control. It ensures that both the customer and the admin can remove try-on records permanently when needed.


FieldDescription
ID

Unique identifier for each try-on record stored in the system. Helps in tracking records for

both customers and admins.

Customer Email (Admin view only)

Displays the customer’s email address who performed the try-on. Useful for filtering and

support purposes.

Product SKU

SKU of the product selected for try-on. Helps identify which garments are most engaged

with.

Garment Image

Original product/garment image chosen for the try-on. Shown in both customer and admin

views.

Model ImageThe customer’s uploaded photograph is used for generating the AI try-on result.
Generated Image

AI-processed result showing how the garment looks on the customer’s photo. Available in

thumbnail and expandable “View Fullsize Picture” formats.

Created AtTimestamp of when the try-on record was generated. Useful for monitoring activity trends.
Delete (Action)

Provides the admin the authority to delete any record, enabling compliance with data

deletion requests, storage optimization, or internal cleanup.

Frontend Functionality


AI Self Try-On (PDP Page)

  • On the product detail page, customers can use the AI Self Try-On feature to visualize how a product will look on them before making a purchase.

    • The section titled “See How this outfit looks on you?” allows customers to:

      • View the selected garment image.

      • Upload their own photograph.

      • Instantly see an AI-generated preview of themselves wearing the product.

    • Customers can also click on “View Fullsize Picture” to see a larger version of the try-on result.

    • The “View All Try-ons” button lets customers review their entire try-on history.

  • This feature enhances the shopping experience by giving customers a realistic preview of products, helping them make more confident purchase decisions.

My AI Try-Ons (User Dashboard)

  • The My AI Try-Ons section in a customer’s account dashboard provides a history of all garments the customer has virtually tried on using the AI Self Try-On feature.

    For each try-on entry, the following details are displayed:

    1. Garment Information

      • Shows the product name (e.g., Chaz Kangeroo Hoodie-XS-Black).

      • Displays the selected garment image under the label “You are trying below garment”.

      • Includes the date when the try-on was generated (e.g., Generated on: Sep 8, 2025).

    2. Customer Photograph

      • Shows the photo uploaded by the customer under the label “Upload Your Photograph”.

    3. AI-Generated Try-On Result

      • Displays how the customer looks wearing the garment under the label “See how you look with this outfit.”

      • Includes a “View Fullsize Picture” button for opening a larger version of the generated image.

    4. Delete Button

      • Each try-on entry includes a Delete button (red) in the top-right corner.

      • Clicking this button allows the customer to remove that specific try-on record from their history.

      • This ensures customers can manage and clean up their try-on records as per their preference.

View Fullsize Picture

  • When the customer clicks on the “View Fullsize Picture” button, a larger version of the AI-generated try-on image is displayed.

    • This view allows the customer to:
        • Clearly see how the selected product looks on their uploaded photograph.

        • Examine product details and fit more closely in the AI-generated result.

        • Get a better visualization before making a purchase decision.

  • This feature ensures customers have a more realistic and detailed preview of the product for themselves.

Important Configuration: To enable this functionality, make sure the option “Show View Full Size Button” is set to Yes in the configuration settings.

Demo


Click here to visit the backend admin panel.
Click here to visit the frontend.

FAQs


Click here to visit FAQs.

Support


Click here to raise a support ticket using your MageDelight account.

Additional Services


Click here to get the customized solution for this extension.



Thank you for choosing MageDelight!



  • No labels