Welcome to Eight Docs

Installation: Product Selector

Depending on which theme you are installing Assemble onto, you may be required to manually add snippets to your theme code files in order to get the app working.

Some newer themes will already support subscription plan selection. However, if you have an older version of a theme which does not already support this, you can add this functionality manually in a few simple steps. 

Step 1: Duplicate Your Theme


Due to the far-reaching nature of altering theme code-files, Shopify recommends duplicating your theme to create a backup copy before adding apps, allowing you to start again if you need to.

  1. Within your Shopify admin, go to Online Store > Themes.
  2. Select your theme, and click Actions > Duplicate.



Step 2: Copy the Snippet


Under Installation, go to Plan Selector, and click the snippet {% render 'assemble', type: 'product-plan' %}to copy it onto your clipboard.



Once the snippet has been copied, a 'Copied!' note will appear for confirmation.

Step 3: Locate Your Product Template


The next step is to locate your product template, which is usually located within a file referenced by a section,render, or include tag, such as templates/product.liquid or sections/template--product.liquid.


Warning: The location of the product template varies depending on which theme you're installing Assemble onto. If you are having trouble locating it, feel free to contact our friendly support team at app-support@weareeight.com.


Step 4: Locate Where to Paste the Snippet


Once you have located your product template, you can choose where you would like your product selector to appear on your product page. As a guide, this should be in the area between  {% form 'product' and {% endform %} within your product template file.


To locate the starting point of this area:

  1. Select Crtl + F to enable to search function.
  2. Enter {% form 'product' into the search bar.
  3. Make a note of which line this falls on.



To locate the end point of this area:

  1. Enter {% endform %} into the search bar.
  2. Make a note of which line this falls on.


Step 5: Paste the Snippet into the File


Once you have located the start and end point of this area, paste your snippet on an empty line between these two points. 

Where your subscription purchase options appear on your product page depend on where you paste your snippet.

Warning: Do not replace any existing code.


Once this has been completed, click Save.

Was this article helpful?