# Configure Amaspace in Shopify

> Step-by-step guide to connecting Amaspace Customizer in Shopify: add the block, paste your Secret API Key, and enable 3D product customization.

Guide, 5 min. Source: https://amaspace.co/guide/how-to-install-amaspace-customizer-in-shopify

> On this page you’ll find a short setup guide: from first connection to placing the configurator on your store pages. Each step is illustrated with a screenshot.
If you haven’t installed the app yet, you can do it here: [https://apps.shopify.com/amaspace](https://apps.shopify.com/amaspace)

## Step 1 — Connect your Shopify store to Amaspace

After installing the app you will be **automatically redirected** to the Amaspace platform.

If your Shopify store is already connected, you’ll go straight to your Amaspace dashboard.
If not, you’ll see an **“Access error (403)”** card with two buttons:

![Screenshot of the Amaspace Integration 403 access error, asking to add the site in Account Integrations, with “Go to settings” and “Create Account” buttons.](https://cdn.sanity.io/images/09rhsc6e/production/1c34e35eef3b16e7e1bb170de243557bc23e19ba-990x325.png)

1. **Create Account** – if you’re new to Amaspace
2. A new Amaspace account is created automatically using your Shopify details.
3. Your Shopify store is added to **Account Integrations** and linked to this account.
4. **Go to settings** – if you already have an Amaspace account but no integration
5. You’ll be redirected to **Account Integrations**: [https://app.amaspace.co/integrations](https://app.amaspace.co/integrations).
6. Add this Shopify store to your integrations and save.

## Step 2 — Choose your pricing plan

![Screenshot of the Amaspace pricing page showing multiple subscription plans with their features and a button to select a plan.](https://cdn.sanity.io/images/09rhsc6e/production/486f41751c2fedf890c5342ef904ea1d395ac364-1757x728.png)

- After connecting, you’ll be redirected to the **pricing plans** page.
- Review the features in each plan and choose the one that fits your needs.
- Confirm the plan to unlock Amaspace features.

## Step 3 — Create a product in Amaspace

1. Go to the product catalog: [**https://app.amaspace.co/catalog**](https://app.amaspace.co/catalog)

![Screenshot of the Amaspace product catalog page at app.amaspace.co/catalog with a list of products.](https://cdn.sanity.io/images/09rhsc6e/production/3fb4cfdd6b56497410a9584cb258d1ef418b3826-1600x379.png)

 2. Click **Create product**.  

![Screenshot of the Amaspace catalog showing the “Create product” button highlighted.](https://cdn.sanity.io/images/09rhsc6e/production/a50747d16809cf7af0bb88ee1dc7936ea0d9a8fe-1868x542.png)

3. Choose how you want to add a 3D model:

![Screenshot of the product creation screen with options to upload a 3D model, use the product library, or request a custom model.](https://cdn.sanity.io/images/09rhsc6e/production/98052cbd5eccd8ba129e75b60397fc08674e70d9-892x773.png)

- upload your **own 3D model -** *Use my model*,
- use a model from our **product library -** *Use ready-model*,
- or **request** a custom 3D model from our team - *Request a model*.

 4. Fill "Full name" product field and "Details" (optional) and save.

 5. For advanced configuration (options, materials, rules, animations), see our detailed [3D configuration guide](https://amaspace.co/guide/boat-configurator-guide)

## Step 4 — (Optional, recommended) Link your Amaspace product to a Shopify product

This step lets the configurator:

- appear automatically on a specific **Shopify product page**,
- save each configuration as a **variant** of that product (instead of creating a new product every time).

   1. In Shopify admin, open **Products → [your product]** and copy the **product ID** from the URL.

![Screenshot of the Shopify product editing page with the product ID visible in the browser URL.](https://cdn.sanity.io/images/09rhsc6e/production/a9f5596500ac8195d3291bc761e21e3af605cda0-1188x763.png)

   2. In Amaspace, go to [**https://app.amaspace.co/catalog**](https://app.amaspace.co/catalog), open the product and switch to **PCO & Assets**.

![Screenshot of an Amaspace product page with the “PCO & Assets” tab open in the interface.](https://cdn.sanity.io/images/09rhsc6e/production/78378a439c0ec35a9ce83f8594e8cef057a110e9-1770x389.png)

   3. Click **Publish → Shopify integration** and paste the **Shopify product ID**, then save.

![Screenshot of the Amaspace Publish dialog with Shopify integration selected.](https://cdn.sanity.io/images/09rhsc6e/production/e9e17d057d07363a9bdc34f5fd91717709efb9d6-455x514.png)

![Screenshot of the Amaspace Publish dialog with a field to paste the Shopify product ID before saving.](https://cdn.sanity.io/images/09rhsc6e/production/bb258ed3a0a17ad8deea30a55c91298c0db92286-582x320.png)

## Step 5 — Add the configurator to your Shopify theme

**5.1. Open** **[https://app.amaspace.co/integrations](https://app.amaspace.co/integrations)****and copy your Secret API Key** 

![Screenshot of the Amaspace Integrations page showing the Shopify integration section with the Secret API Key (Ama Token) visible for copying.](https://cdn.sanity.io/images/09rhsc6e/production/c8ea978a91cf9326886784bc3b01d6dae0ab1a83-1774x263.png)

**5.2. In Shopify admin go to Online Store → Themes → Customize.**

![Screenshot of the Shopify admin showing the Online Store → Themes section with the Customize button highlighted.](https://cdn.sanity.io/images/09rhsc6e/production/344c6f6343aa8b8195f56f3bd917685d84a9cba3-1519x579.png)

**5.3. Product Customizer on a product page (recommended)**

   1. Open your **Product** template.

   2. Click **Add section → Apps → Product Page Customizer**.

![Screenshot of the Shopify theme editor “Add section” panel with the Apps category open and the Amaspace Product Customizer block selected.](https://cdn.sanity.io/images/09rhsc6e/production/cdd98550b5281266aad762778b22a8f95e63c7b9-1873x756.png)

   3. In the block settings, paste your **Secret API Key / Ama Token**.

![Screenshot of the Shopify theme editor showing the Amaspace Product Customizer app block on the product page and the settings panel with the Ama Token field filled in.](https://cdn.sanity.io/images/09rhsc6e/production/62c69f13e791532060e73c34d74b041e57992aac-1869x780.png)

   4. Click **Save**.

If the product is linked as in Step 4, the correct configurator will appear on this product page and each configuration will be stored as a **variant**.

**5.4. Page Customizer on any page**

   1. In the theme editor, open the page template where you want the configurator (home, landing, custom page, product, etc.).

   2. Click **Add section → Apps → Page Customizer**.

![Screenshot of the Shopify theme editor “Add section” panel with the Apps category open and the Amaspace AMA Customizer block selected.](https://cdn.sanity.io/images/09rhsc6e/production/32ea135ee300791fbc74e2454102b26fe193ec5a-1872x532.png)

   3. Paste your **Secret API Key / Ama Token** into the settings.

![Screenshot of the AMA Customizer app block settings panel showing the Ama Token field filled with the Secret API Key.](https://cdn.sanity.io/images/09rhsc6e/production/11a0ffe3905cfa81e4a42b3ccdedda08d848130d-1817x385.png)

   4. In **Product for customization**, paste the **Product ID** from Amaspace ([https://app.amaspace.co/catalog](https://app.amaspace.co/catalog)).

![Screenshot of the Amaspace Catalogue page showing the Products with ID visible for copying.](https://cdn.sanity.io/images/09rhsc6e/production/9d895f71a5da0332449446bb61313fec5ae4c4b9-2930x750.png)

   5. Paste your Amaspace Product ID**** into the settings.

![Screenshot of the Page Customizer app block settings panel showing the Product for customization field filled with the Amaspace Product ID.](https://cdn.sanity.io/images/09rhsc6e/production/11a0ffe3905cfa81e4a42b3ccdedda08d848130d-1817x385.png)

   6. If you leave this field empty, the **first published product** in your Amaspace catalog will be shown by default.

   7. Click **Save**.

## Step 6 — Your configurator is live 🎉

Your Amaspace configurator is now connected and visible in your Shopify store.

![Screenshot of a Shopify product page with the Amaspace 3D configurator embedded and ready for customers to customize the product.](https://cdn.sanity.io/images/09rhsc6e/production/a992ce97e9e4715f96d468298cae9228c3ca1e1d-2400x1792.png)
