Documentation / Getting started / Theme Setup

Theme Setup

Configure your Shopify theme for the best Instant Art Kit experience

Automatic Button Hiding

When you add the Instant Art Kit block to a product page, the app automatically hides your theme’s native add-to-cart button, quantity selector, and variant options. This prevents duplicate controls since the Instant Art Kit modal handles all product options.

This works automatically with most themes including Dawn, Debut, and other popular Shopify themes.

For guaranteed compatibility with any theme, we recommend creating a dedicated product template. This is Shopify’s official approach and ensures 100% reliable button hiding.

Step 1: Open the theme editor

  1. Go to your Shopify admin
  2. Navigate to Online Store > Themes
  3. Click Customize on your active theme

Step 2: Create a new product template

  1. In the theme editor, click the page selector dropdown (shows “Home page”)
  2. Select Products > Create template
  3. Name it instant-art-kit and click Create template

Step 3: Remove native product form elements

In your new template:

  1. Find the Product information section in the left sidebar
  2. Click the eye icon to hide these blocks:
    • Buy buttons (or “Add to cart”)
    • Quantity selector
    • Variant picker (optional - hide if Instant Art Kit handles all your variants)
  3. Click Save

Why hide these blocks?

Instant Art Kit provides its own add-to-cart flow through the upload modal. Hiding the native buttons prevents customer confusion and ensures they use the custom photo upload experience.

Step 4: Assign the template to products

  1. Go to Products in your Shopify admin
  2. Open a product that uses Instant Art Kit
  3. In the right sidebar, find Theme template
  4. Select instant-art-kit from the dropdown
  5. Click Save

Repeat for all products using Instant Art Kit, or use bulk editing to assign the template to multiple products at once.

Adding the Instant Art Kit Block

After setting up your template:

  1. Return to the theme editor
  2. Navigate to your instant-art-kit template
  3. In the Product information section, click Add block
  4. Select Instant Art Kit from the Apps section
  5. Position it where you want the upload button to appear
  6. Click Save

Troubleshooting

Native buttons still visible

If you see duplicate buttons after adding the Instant Art Kit block:

  1. Check your template - Ensure the product is using your custom instant-art-kit template
  2. Check block visibility - Make sure the Buy buttons block is hidden (eye icon should show it’s hidden)
  3. Hard refresh - Press Ctrl+F5 (Windows) or Cmd+Shift+R (Mac) to clear your browser cache
  4. Check for custom theme code - Some themes add buttons via custom code that may need manual removal

Instant Art Kit block not available

If you don’t see Instant Art Kit in the block list:

  1. Ensure the app is installed and active
  2. Refresh the theme editor (press F5)
  3. Check that you’re editing a Product template (not Home or Collection)
  4. Try adding the block from a different browser

Upload button appears but doesn’t work

If the upload button appears but clicking it does nothing:

  1. Check your browser console for JavaScript errors
  2. Ensure the product has a product mapping configured
  3. Try disabling other apps temporarily to check for conflicts

Next steps