Installation

These steps add a Malachyte recommendations row to the store's product pages. They work on any theme: the live theme, a duplicate, or a theme deployed from a repository. The client's Malachyte contact sends the values needed: the endpoint, token, component ID, and the section file.

1. Install the Malachyte app

Install the Malachyte app on the Shopify store. The Malachyte contact sends what is needed to install it.

2. Turn on the Malachyte Config app embed

In the Shopify theme editor, open App embeds in the left sidebar and switch on Malachyte Config. Enter the Endpoint and Token from the Malachyte contact, then click Save.

3. Add the Malachyte products section

In Shopify Admin, open the theme's Edit code view, choose Add a new section, and name it malachyte-products. Delete the starter code, paste in the contents of the malachyte-products.liquid file from the Malachyte contact, and click Save.

Copy the code from the .liquid file itself, not from a PDF. Copying from a PDF can break long lines.

4. Add the Malachyte Recommendations block to the product templates

For each product template that should show recommendations:

1. Open the template in the theme editor and choose Add section, then Apps.
2. In the new Apps section, choose Add block and add Malachyte Recommendations.
3. Move the Apps section to where the row should appear, for example directly below the existing related products.

5. Enter the block settings

In the Malachyte Recommendations block, enter the Component ID from the Malachyte contact. Set the heading, product limit, and products per row to match the theme, leave Wait for A/B test to activate on, and click Save.

6. Let the Malachyte contact know

Tell the Malachyte contact once the changes are on the theme. Malachyte will confirm everything is working and activate the row.