> ## Documentation Index
> Fetch the complete documentation index at: https://help.mockspark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation Guide

> Step-by-step instructions for installing the Shopify app and enabling it in your store theme.

# Install the Shopify App

Go to the [Shopify App Store](https://apps.shopify.com/) and type `mockspark` into the search bar at the top. Find the app called **Mockspark Product Personalizer**, then click to open its details page and select Install.

<Frame>
  <img src="https://mintcdn.com/mockspark/xOzVRo5E7JiNiaeK/images/connections/shopify/PixPin_2025-08-20_12-31-59.png?fit=max&auto=format&n=xOzVRo5E7JiNiaeK&q=85&s=f7adb6c3789d1a402d46cb9ea4fe554b" width="1200" height="494" data-path="images/connections/shopify/PixPin_2025-08-20_12-31-59.png" />
</Frame>

Shopify will redirect you to your store’s admin page, where you can review the permissions required by the app. Click the **Install** button to begin installation.

If the process completes without any issues, Mockspark will be successfully added to your Shopify store.

<Frame>
  <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-08-20_12-28-27.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=f898b24c915526bc2137f3bd0be39378" width="1200" height="503" data-path="images/connections/shopify/PixPin_2025-08-20_12-28-27.png" />
</Frame>

# Enable the App on Your Theme

After you’ve installed the **Mockspark Product Personalizer** app from the [Shopify App Store](https://apps.shopify.com/mockspark), just follow a few simple steps to enable the app in your current **Online Store Theme**. This will complete the setup and connect Mockspark with your Shopify store.

1. Log in to your **Shopify admin** and navigate to **Sales channels** on the left sidebar. Click on **Online Store**, and you’ll be taken to the `Themes` page by default.
2. Find your current `Online Store theme` and click the **Customize** button on the right side. This is where you’ll make a few setup changes to enable the app.

<Frame>
  <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-06-30_15-48-05.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=ed49f4e728baf28fb9448443bbc677a1" width="1200" height="896" data-path="images/connections/shopify/PixPin_2025-06-30_15-48-05.png" />
</Frame>

### Enable the App Embed

1. On the `theme customization` page, click the third icon in the left-hand sidebar to switch to the App Embeds panel.
2. In the `App Embeds` panel, locate the toggle for **Mockspark** and turn it on to enable the app.

<Frame>
  <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-06-30_15-50-48.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=fdb1f4b6adcf072df2ced99f073c578f" width="1200" height="954" data-path="images/connections/shopify/PixPin_2025-06-30_15-50-48.png" />
</Frame>

### Add the Design Button

After enabling the `Mockspark App Embed`, the next step is to add the `Mockspark design button` to your product detail pages.

1. At the top of the `theme customization` page, click the dropdown that says **Home page**.
2. From the dropdown menu, select **Products**.

<Frame>
  <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-06-30_15-51-48.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=01a6a1c0fd38dbc5e7e386800e178314" width="1200" height="954" data-path="images/connections/shopify/PixPin_2025-06-30_15-51-48.png" />
</Frame>

Click on **Default product** to open the template editor for the product detail page.

<Warning>The name of the product detail page template may vary depending on the theme you're using. If you're using a paid third-party theme, we recommend reaching out to the theme developer for guidance.</Warning>

<Frame>
  <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-06-30_15-52-31.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=e414b92baa1abbda0452e44dec4416a1" width="1200" height="954" data-path="images/connections/shopify/PixPin_2025-06-30_15-52-31.png" />
</Frame>

In the `product detail` page template, choose a spot where you’d like the `Mockspark design button` to appear. A common placement is just above the Add to Cart button.

Move your cursor to the area where you want to add the button. A blue interactive highlight will appear on the screen. Click the plus(<Icon icon="plus" iconType="solid" />) icon to insert the element.

<Frame>
  <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-06-30_15-55-12.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=91d0728dd936277eafbdf24728b9cf9b" width="1200" height="954" data-path="images/connections/shopify/PixPin_2025-06-30_15-55-12.png" />
</Frame>

<br />

<Accordion title="Another Way to Add the Design Button">
  In addition to visually adding the `Mockspark design button` within the product detail page template, you can also add it through the **Sections** panel.

  <Warning>Just pick the way that works best for you.</Warning>

  1. Click the first icon in the left-hand sidebar to switch to the **Sections** panel.
  2. Under the **Template** module, select **Product information**.
  3. In the expanded list, find **Buy buttons**, then right-click on it.
  4. From the context menu, select **Add block before** to insert the button above the Buy buttons section.

  <Frame>
    <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-06-30_15-56-50.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=94e13844b67c3a8b8ec1db497f7bf2a6" width="1200" height="954" data-path="images/connections/shopify/PixPin_2025-06-30_15-56-50.png" />
  </Frame>
</Accordion>

1. Once you've selected the insertion point, a dialog box will appear on the screen. In the dialog box, switch to the **Apps** tab.
2. After switching to the `Apps` tab, scroll down and select the **Mockspark design button**.

<Frame>
  <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-06-30_16-08-19.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=6fcff956166b14092e41db41807e7cda" width="1200" height="954" data-path="images/connections/shopify/PixPin_2025-06-30_16-08-19.png" />
</Frame>

1. Now, in the product detail page template, you'll see the **Mockspark design button** we just added. Select the button, which is labeled `Customize` by default.
2. After selecting the Mockspark design button, the **settings panel** will appear on the screen. From here, you can customize the button’s **style** to better match your store’s theme and overall look. You can also change the **text** that appears on the button.
   <Tip>The Mockspark Design button settings panel may appear on either the left or right side of the screen, depending on the width of your current display.</Tip>
3. After you finish configuring the button, make sure to click the **Save** button in the top right corner of the page. Otherwise, your changes will not be saved.

<Frame>
  <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-06-30_16-10-05.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=f1c1d48f360e0c57d9dfc57708959afe" width="1200" height="954" data-path="images/connections/shopify/PixPin_2025-06-30_16-10-05.png" />
</Frame>

That’s it! You’ve successfully enabled the **Mockspark Product Personalizer** app in your current Online Store theme. To exit the theme editor, click the **Exit** button in the top left corner of the page.

<Frame>
  <img src="https://mintcdn.com/mockspark/I3uQFtsObRHJPdKX/images/connections/shopify/PixPin_2025-06-30_16-11-23.png?fit=max&auto=format&n=I3uQFtsObRHJPdKX&q=85&s=621cd055c962c0d61de95fdf2af21efe" width="1200" height="954" data-path="images/connections/shopify/PixPin_2025-06-30_16-11-23.png" />
</Frame>

# Next steps

If everything went smoothly, you’ve successfully installed and enabled Mockspark. Now it’s time to create and publish your first customizable product.

Let’s get started:

<Card horizontal title="Quick Start Guide" icon="rocket" href="/docs/get-started/quickstart">
  Start selling your customizable products in minutes
</Card>
