> For the complete documentation index, see [llms.txt](https://shopvid.gitbook.io/shopvid-shoppable-video-reels/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shopvid.gitbook.io/shopvid-shoppable-video-reels/getting-started/quick-start.md).

# Quick start

### Why Use Quickstart?

The Quickstart feature helps you:

* **Save time** by following a proven setup process
* **Launch faster** with only the essential steps needed

### How to Use Quickstart

#### Step 1: Enable Shopvid in Your Theme

First, you need to activate Shopvid in your Shopify theme settings to allow the app to display videos on your store.

{% embed url="<https://app.arcade.software/share/s6bhBgkcKJ11pYIKaIxu>" %}

**To enable the app:**

1. Click **Enable App** in Step 1
2. You'll be redirected to your Shopify theme editor
3. In the App embeds section, find "Shopvid"
4. Toggle the switch to **ON** position
5. Click **Save** in the top right corner
6. Return to the Shopvid app to continue

> **Note:** The app must be enabled for videos to appear on your store. This is a one-time setup.

#### Step 2: Import Your Videos

Now it's time to add video content to your library.&#x20;

{% embed url="<https://app.arcade.software/share/zVtwnv1LCwGfClENK9E6>" %}

You can upload your own videos with these specifications:

**Video requirements:**

* **Format:** MP4 only
* **Maximum size:** 20 MB per video
* **Maximum videos:** 10 videos

**To import videos:**

1. Click **Import Video** in Step 2
2. You can select up to 10 MP4 files (max 20 MB each)
3. Please wait while processing. You can still exit the app or browse other pages — your videos will continue uploading.
4. Your videos will appear in the library when ready

> **Need help with large videos?** Contact our support team via chatbot for help with video compression and scaling.

#### Step 3: Create Your First Widget

A widget is a container for your shoppable videos. You'll customize how videos display and add shopping features.

{% embed url="<https://app.arcade.software/share/dPwoxEs3sSwuiR1rgjgP>" %}

**To create a widget:**

1. Click **Create Widget** in Step 3
2. Give your widget a name (e.g., "Homepage Featured Products")
3. **Add videos to your widget:**
   * Click **Add Videos**
   * Select videos from your library
   * Click **Confirm Selection**
4. **Configure display settings:**

* **Gallery View:**&#x20;
  * Play Video:
    * None: Videos play only when clicked
    * Autoplay on Hover: Videos start playing when customers hover over them (this feature is not available on mobile)
* **Full Screen:**
  * Seek Control:
    * On: Customers can skip to different parts of the video
    * Off: Videos play from start to finish only
  * Mute Control:
    * On: Shows mute/unmute button for audio control
    * Off: No audio control available to customers

1. Click **Save Widget**
2. Copy the **Widget ID** shown on screen (you'll need this next)

#### Step 4: Add the Widget to Your Store

{% embed url="<https://app.arcade.software/share/VYVoZu4SynwdmlZ6zIZe>" %}

The final step connects your widget to your storefront where customers can see it.

**To display your widget:**

1. Click **Add to Store** in Step 4
2. You'll see your Widget ID (e.g., `WIDGET_12345`)
3. Click **Copy Widget ID**
4. Navigate to your theme customizer:
   * Go to **Online Store** > **Themes**
   * Click **Customize** on your current theme
5. Add a "Custom Liquid" or "Shopvid Widget" section where you want videos
6. Paste your Widget ID in the designated field
7. Click **Save** in the theme editor
8. Preview your store to see your shoppable videos live!

> **Tip:** You can add the same widget to multiple pages or create different widgets for different sections of your store.

### Best Practices

* **Start with your best content** - Choose high-quality videos that showcase your products clearly
* **Keep videos short** - 15-60 seconds performs best for engagement
* **Test on mobile** - Most customers shop on mobile devices
* **Monitor performance** - Check analytics after launching to optimize placement


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://shopvid.gitbook.io/shopvid-shoppable-video-reels/getting-started/quick-start.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.