How to install GO SUB code
You can watch it without sound by turning on the captions on YouTube.
Go Sub Tutorial Video ListHow to install themes compatible with Online Store 2.0
If you are using an app block, the code will be automatically updated.
Also, when you delete the app, the code will be automatically removed from the theme.
Detailed information following the steps is provided in related articles.
If you have trouble installing the theme, please read this.
Adding app blocks to the product page
[Install Theme] > [Select Theme] > Click [Open Product Page in Theme Editor]
Click [Add Block] > [Go Sub Block]
Drag and drop the app block to any position.
Adding an app block to the customer account page.
The installation method varies depending on the type of customer account.
Please check which option is selected under Shopify > Settings > Customer Accounts.
For 'Customer Account'.
Add blocks from the Checkout Customizer.
Click Customize under Shopify > Settings > Checkout.
Add blocks on the order screen.
Nothing will be displayed in the preview, but that's okay.
Similarly, you can add blocks to the order status page. Please add them using the same procedure as above.
Regarding the visibility of the reorder button
If the reorder button is turned on, unintended orders may occur. Even if the reorder button is pressed from the order history in subscriptions, a subscription will not be created. To avoid confusion, please ensure that the visibility of the reorder button is turned off in the checkout customizer.
For traditional customer accounts
If the customer's account settings are from the 'previous version', insert the GO SUB block from the theme customizer.
Proceed to Online Store > Customize and select the customer account from the traditional customer accounts.
*The next screen will prompt you to log in. Please create a temporary account, log in on the customizer, and proceed to the next screen.
Insert the GO SUB app block within the account page.
Adding an app block to the cart page (optional)
There are two types of blocks that can be added to the cart page. Each is designed to prevent unintended changes or purchases, and installation is optional.
- Cart operation control when selling subscription boxes
- Alert display when mixing subscription plans
Cart operation control during subscription box sales
A subscription box becomes a single contract only when products are bundled together. If customers are allowed to freely change or delete products on the cart screen, it may lead to unintended sales (such as sales at 0 yen or not meeting the requirements for the box). Therefore, please use the control block to manage operations as necessary.
For more details on cart operation control during subscription box sales, click here
Alert display when mixing subscription plans
If payments are made under multiple subscription plans, there is a possibility that contracts that should be separate will be consolidated into one, leading to unintended discounts and other errors if the following conditions are met. The integration of contracts is subject to Shopify's specifications, but it can be controlled through app blocking.
【Examples of Contract Integration】
- Same order cycle (once every 30 days, once a week, etc.)
- Same minimum and maximum purchase frequency
Example 1: Purchase Product A with Plan ① + Purchase Product B with Plan ②
- Both Plan ① and ② are once every 30 days.
- No minimum or maximum purchase frequency settings.
- Plan ① has a 30% discount rate, and Plan ② has a 50% initial discount followed by 10% thereafter.
In this case, the subscription contracts for Product A and B are merged, and the discount rate of Plan ① is applied to all, resulting in the original discount rate not being applied and causing an error.
Example 2: PurchaseProduct A with Plan ① + Purchase Product B with Plan ②
- Plan ① is once every 30 days, Plan ② is once every 60 days
- No minimum or maximum purchase frequency settings
- Plan ① has a discount rate of 30%, and Plan ② has an initial discount of 50% followed by 10%.
In this case, the plans are not merged, and a separate contract is created, resulting in correct operation.
If it is necessary to prevent unintended contract merging like in Example 1, please add a 'Plan Alert Block' to the cart page.
This will display an alert as shown below. The displayed text can be changed in the app management screen under Settings > Translation, Text Changes.
If you want to display alerts but still allow checkout as is, please turn off this checkbox in the app block settings.
Notes on Quick Add (feature off recommended)
If quick add from the product card to the cart is enabled, the subscription plan will not apply and will be processed as a regular sale . To prevent unexpected sales, we recommend that the quick add feature be set to off .
Advanced customization for engineers
If you want to make the quick add feature mandatory, please add the 'GO SUB Quick Add block' to the theme's index template or collection template, and take the following actions.
- If a subscription plan exists, transition to the product page instead of quick add (edit Liquid code)
- Customize the quick view modal (edit Liquid code and JavaScript)
Please also check the notice regarding buttons such as 'Buy Now', 'Quick Add', and 'Reorder' in the app management screen > Theme Installation.
Themes not compatible with Online Store 2.0
Due to difficulties in supporting app updates, we recommend using themes compatible with OS 2.0. If installation on a non-compatible theme is necessary, please fill out the required information on the application form.
How to check for Online Store 2.0 compatible themes
[Online Store] > [Theme] > [・・・] > Click [Edit Code]
Check [Template]
File extension .json => OS2.0 compatible
File extension .liquid => OS2.0 incompatible
