---
title: "Get started"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/online-store-3-0-themes/integrate-apps-with-themes/theme-app-extension/get-started'
  md: 'https://developer.shopline.com/docs/online-store-3-0-themes/integrate-apps-with-themes/theme-app-extension/get-started.md'
---
# Get started

This guide walks you through integrating a theme app extension into a theme, from creation to publication.

* * *

## Prerequisites{#IshxU}

-   Create a [SHOPLINE partner account](https://developer.myshopline.com/home/index).
    
-   [Create an app](https://developer.shopline.com/docs/apps/development-tool/shopline-cli/build-apps-using-shopline-cli.md) in the [Partner Portal](https://developer.myshopline.com/home/index).
    
-   Create a [development store](https://developer.shopline.com/docs/apps/development-tool/development-stores/overview.md) in the Partner Portal.
    
-   Install your app in the development store.
    
-   Install the [SHOPLINE CLI](https://developer.shopline.com/docs/online-store-3-0-themes/development-tools/cli/overview.md).
    
-   Install an OS 3.0 version theme for your development store.
    

* * *

## Step 1: Create a theme app extension locally{#G6A52}

Use the SHOPLINE CLI to locally create a directory for your theme app extension.

1.  Open a terminal and navigate to an empty directory.
    

```bash
cd <my-directory>
```

2.  Log in to your development store.
    

```bash
sl login --store <MY_STORE>.myshopline.com
```

3.  Create a theme app extension.
    

```bash
sl extension create
```

4.  Follow the prompts to select the appropriate options. After completing the selections, you will see a folder named `theme-app-extension` in your directory.
    
    <img src="https://s2cdn.myshopline.com/slfs/op-new/175196171783640/1748420832065-532839b3-aee5-4e9b-9d35-b284681fbb52.png" alt="" />

* * *

## Step 2: Push the theme app extension{#sB8Nk}

1.  Navigate to the theme app extension directory.
    

```bash
cd theme-app-extension
```

2.  Push the theme app extension.
    

```bash
sl extension push
```

3.  Follow the prompts and choose the appropriate options.
    
    <img src="https://s2cdn.myshopline.com/slfs/op-new/175196151476442/1750129094486-afca56e6-783f-4867-8da6-369039e717a1.png" alt="" />
4.  Click the link to visit the SHOPLINE Partner Portal. Find the theme app extension and click the toggle button as shown in the following image to change the app extension to a draft version.
    
    <img src="https://s2cdn.myshopline.com/slfs/op-new/175161537225323/1750129210864-a21d4213-2efe-4cac-9eb6-0cbcb768218d.png" alt="" />

* * *

## Step 3: Test your changes{#yTqYZ}

1.  In your SHOPLINE Admin, go to **Online Store**, select the OS 3.0 version theme, and click the **Design** button to enter the theme editor.
    
2.  In the theme editor, click **Add component**, select the **Apps** tab, and add your app to the theme.
    
3.  Save the changes to the theme.
    
4.  Verify that the theme app extension functions as expected.
    

* * *

## Step 4: Publish the theme app extension{#RwYdq}

1.  Push the theme app extension to the SHOPLINE Partner Portal.
    

```bash
sl extension push
```

2.  After a successful push, the system will automatically generate and display a link in the terminal, which directs to the current app version page in the Partner Portal.
    
3.  Click the link to enter the app version. Then click **Create new version.**
    
4.  Close and disable the preview of the draft version extension.
    
    <img src="https://s2cdn.myshopline.com/slfs/op-new/175161550821200/1750659980394-9e4c9f31-64b0-4748-ab73-efd09e94eae0.png" alt="" /><img src="https://s2cdn.myshopline.com/slfs/op-new/175161552935530/1750659986286-246c6086-c612-4113-810d-8a138245923c.png" alt="" />
5.  Click the back button, find **App version**, and click to enter. Then create and publish the extension version here.
    
    <img src="https://s2cdn.myshopline.com/slfs/op-new/175196158651619/1750131864962-b3e6d84f-e028-47a8-b571-b28778db24e0.png" alt="" />