Common troubleshooting and setup guides.
1. Selling Plan: Ensure the product has an active Selling Plan (Settings > Apps > Subscriptions).
2. App Block: Verify you have added the "Subscription Widget" block to your Product Page in the Theme Editor.
3. Visibility: Check if "Hide if no subs" is enabled in the Block settings.
The servings count and per-serving price are only displayed when the custom.serving_count metafield is set on the variant.
Step 1 — Create the metafield definition
Go to Settings > Custom data > Variants and click Add definition.
Step 2 — Configure the definition
• Name: serving_count
• Namespace and key: custom.serving_count
• Type: Integer (under "Number")
Click Save.
Step 3 — Set the value on each variant
Go to a product, scroll down to the Variants section and click on a variant. Scroll to Metafields and enter the number of servings (e.g. 30). Click Save. Repeat for each variant.
The widget will automatically display the servings count and per-serving price once the metafield has a value.
All styling is handled in the Theme Editor. Click on the Subscription Widget block to change colors, border radius, and labels.