> For the complete documentation index, see [llms.txt](https://guide.swiftxr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.swiftxr.io/how-to/how-to-add-the-swiftxr-custom-block-to-the-media-image-section-on-shopify.md).

# How to Add the SwiftXR Custom Block to the Media Image Section on Shopify

This guide will show you how to embed your SwiftXR 3D/AR/VR viewer directly into your product’s Media Image section on your Shopify store

## Step 1 — Open Your Theme Editor

1. In your Shopify admin, go to Online Store → Themes.
2. Click Customize on the theme you want to edit.

<figure><img src="https://564713456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKNcXDcNRYHUBsVw12Dii%2Fuploads%2FZ39VyKc7qHlSEHyymRrI%2Fshopify%20dtore.jpg?alt=media&amp;token=a9a074cd-32e1-4d40-9ffb-54f744110318" alt=""><figcaption></figcaption></figure>

## Step 2 — Open Your Product Page Template

1. In the top bar of the theme editor, use the dropdown to select a Product Page.
2. Choose the Default product template (or your preferred product template).

<figure><img src="https://564713456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKNcXDcNRYHUBsVw12Dii%2Fuploads%2FwKuHXAEaqfXhrs17vbXq%2Fshopify%20store%202.jpg?alt=media&amp;token=4d799eb3-d418-4bff-ba30-d81fdd5b65fb" alt=""><figcaption></figcaption></figure>

### Step 3 **—** Click and Edit the Product Information Section

1. In the **Product Information** or **Media section**, click the 3 dots.
2. Choose Edit Code

<figure><img src="https://564713456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKNcXDcNRYHUBsVw12Dii%2Fuploads%2F60YevE3VPovpJ7Q2zEAS%2Fshopify%204.jpg?alt=media&amp;token=5bc05ee3-f647-4348-8c51-9eca4f7d4581" alt=""><figcaption></figcaption></figure>

### **Step 4 — Paste the SwiftXR Embed Code**

Paste the following code into your **Custom Liquid** block:

```
// Some code  {% liquid 
      assign swiftxr_product_url = product.metafields.swiftxr.product_url_api
    %}

    {% if swiftxr_product_url %}

      <div style="width: 100%; height: 450px; margin: 0;"> 
        <iframe title="3D Product" frameborder="0" allowfullscreen mozallowfullscreen="true" webkitallowfullscreen="true" allow="fullscreen; autoplay; camera; midi; encrypted-media; gyroscope; accelerometer; magnetometer; xr-spatial-tracking; microphone;" execution-while-out-of-viewport execution-while-not-rendered web-share width="100%" height="100%" src="{{ swiftxr_product_url }}"> 
        </iframe>
      </div>

    {% endif %}
```

<figure><img src="https://564713456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKNcXDcNRYHUBsVw12Dii%2Fuploads%2FU2jzmtxUlQvh42VVIJJi%2FScreenshot%202025-08-28%20175452.png?alt=media&amp;token=4d5bf3fb-b290-455c-b198-968e938e7e3c" alt=""><figcaption></figcaption></figure>

### **Step 5 — Save and Test**

1. Click **Save** in the top right.
2. You should now see the 3D viewer in the media section.

<figure><img src="https://564713456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKNcXDcNRYHUBsVw12Dii%2Fuploads%2FGRryweeUZOdq6rYHAeUM%2FScreenshot%202025-08-28%20175736.png?alt=media&amp;token=35b2e629-4dcf-40fc-ac9e-ed81cce6afcf" alt=""><figcaption></figcaption></figure>
