Skip to main content
This guide is for Tapcart App Studio. You do not need to write code or use the Tapcart CLI. Knit prepares and publishes the block; you add it to the product page and publish. Knit bundles on Tapcart use the same active bundles as your Shopify store. Add to cart goes to Tapcart’s native cart. The discount still applies in Shopify checkout. See How discounts apply.

​
What Knit sets up

Before you start, Knit will have:
  1. Enabled bundle data for your store
  2. Published the Knit Bundle block to your Tapcart app (App Studio → My Blocks)
  3. Pre-configured the block so it points at your store — you normally do not set URLs
If any of these are missing, contact your Knit account manager.

​
Prerequisites

  • Knit app installed on the Shopify store
  • At least one Active bundle in Knit admin
  • Tapcart Enterprise with App Studio access (required for custom blocks)
  • Access to Tapcart App Studio

​
Add the block

1

Confirm the block

Open App Studio, select your app, go to Screens → My Blocks, and confirm Knit Bundle is listed. If it is not, Knit has not published it yet.
2

Place it on the product page

Open the Product Detail Page template. Click Add Block, choose Knit Bundle, and drag it where the widget should appear — typically below product details or above the native Add to Cart button.
3

Optional settings

In most cases leave the right-hand panel as Knit pre-filled it. You do not set a product ID; Tapcart supplies the current product.
4

Save and publish

Save the screen, then Publish the app (or push a preview build).
If Embed base URL is set to the wrong value, the widget stays blank. Clear the field to use automatic store resolution.

​
Verify

App Studio has two previews, and they are not the same:
  • The canvas (drag-and-drop layout) is static. The widget uses a fixed placeholder height. You may see a caption like “Bundle preview — sizes to content on device.” That is expected.
  • “Preview your app” and the installed app run the widget for real. It auto-sizes, including when a product has more than one bundle.
Always verify in Preview your app or on a device.
  1. Open a product that has an Active Knit bundle.
  2. The widget should appear, sized to its content.
  3. Select options and tap the bundle Add to Cart button.
  4. Tapcart cart should show every bundle line.
Then complete a test order and confirm __FB_ATC_UID on the Shopify order lines. See How discounts apply.

​
Troubleshooting

Bundle changes in Knit admin can take up to 5 minutes to show in the app.
Placement is product page only in this version. The block does not replace Tapcart’s native Add to Cart button. Your Shopify web storefront is unchanged.

​
CLI (optional)

If your team has Tapcart Enterprise CLI access and wants to host the block in your own repo, ask Knit for the block project. Most merchants do not need this — Knit publishes the block for you.