If you have existing marketing activity extensions that were created and are managed through the Partner Dashboard, then you should migrate them to Shopify CLI.

## Requirements

- You have [the latest version of Shopify CLI](/docs/apps/build/cli-for-apps/migrate-to-latest-cli).
- Your Partner Dashboard app has been [migrated to CLI](/docs/apps/build/cli-for-apps/migrate-from-dashboard).

## Step 1: Import your Marketing Activity extension locally

1. Navigate to your app's directory.
2. Run the following command:

  <p>
  <div class="react-code-block" data-preset="terminal">
  <div class="react-code-block-preload ThemeMode-dim">
  <div class="react-code-block-preload-bar "></div>
  <div class="react-code-block-preload-placeholder-container">
  <div class="react-code-block-preload-code-container">
  <div class="react-code-block-preload-codeline-number"></div>
  <div class="react-code-block-preload-codeline"></div>
  </div>
  <div class="react-code-block-preload-code-container">
  <div class="react-code-block-preload-codeline-number"></div>
  <div class="react-code-block-preload-codeline"></div>
  </div>

  </div>
  </div>


  <script type="text/plain" data-language="bash">
  RAW_MD_CONTENT#!/bin/bash
  shopify app import-extensions
  END_RAW_MD_CONTENT</script>

  </div>
  </p>


3. Select <code>Marketing Activity Extensions</code> as the type of extension to import.
4. Select an extension to import from the list.

After completing the prompts, a TOML file is generated by importing your extension's existing configurations.

## Step 2: Verify your TOML file

Please review your TOML file to ensure the extension is configured properly. The following is an example of a TOML file that was generated for an imported marketing activity extension:

<p>
<div class="react-code-block" data-preset="file">
<div class="react-code-block-preload ThemeMode-dim">
<div class="react-code-block-preload-bar "></div>
<div class="react-code-block-preload-placeholder-container">
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>
<div class="react-code-block-preload-code-container">
<div class="react-code-block-preload-codeline-number"></div>
<div class="react-code-block-preload-codeline"></div>
</div>

</div>
</div>

<script data-option="filename" data-value="shopify.extension.toml"></script>

<script type="text/plain" data-language="toml">
RAW_MD_CONTENT[[extensions]]
type = "marketing_activity"
name = "My Marketing Activity"
handle = "my-marketing-activity"
title = "Create a marketing ad"
description = "Creates an example marketing ad"
api_path = "/example"
tactic = "ad"
marketing_channel = "social"
referring_domain = "example.com"
is_automation = false

[[extensions.preview_data.types]]
label = "Desktop"
value = "desktop"

[[extensions.preview_data.types]]
label = "Mobile"
value = "mobile"

[[extensions.fields]]
name = "example_field"
heading = "Example Title"
body = "Example body"
ui_type = "paragraph"
END_RAW_MD_CONTENT</script>

</div>
</p>


The following table describes the properties in the TOML file that are specific to a Marketing activity extension:

| Property | Description |
|---|---|
| `[extensions]`<br><span class="heading-flag">Required</span> | Settings related to the template. Contains the following properties:<br></br><ul><li>`title`<span class="heading-flag">Required</span> : The title of the activity.</li><li>`description`<span class="heading-flag">Required</span> : The description of the activity.</li><li>`api_path`<span class="heading-flag">Required</span>: The API path of the hosted [marketing activity endpoints](/docs/api/marketing-activities/endpoints). This is appended to the app's base URL.</li><li>`tactic`<span class="heading-flag">Required</span> : The tactic of the activity. Valid tactics are: <ul><li>`ad`</li><li>`abandoned_cart`</li><li> `affiliate`</li><li>`link`</li><li>`loyalty`</li><li>`message`</li><li>`newsletter`</li><li>`notification`</li><li>`post`</li><li>`retargeting`</li><li>`seo`</li><li>`storefront_app`</li><li>`transactional`</li></ul></li><li>`marketing_channel`<span class="heading-flag">Required</span> : The marketing channel of the activity. Valid marketing_channels are:<ul> <li>`display`</li><li>`email`</li><li>`marketplace`</li> <li>`referral`</li><li>`search`</li><li>`sms`</li><li>`social`</li></ul></li> <li>`referring_domain`: The referring domain of which activity traffic is routed to the shop. If the marketing channel is `email` or `sms`, then the referring domain must be omitted.</li><li>`is_automation`: Whether the activity is a marketing automation. Marketing automations are ongoing activities that are triggered by an event or customer action (for example, an abandoned cart email, message, or notification).</li> |
| `[extension.preview_data.types]` | Types that are used with the [preview endpoint](/docs/api/marketing-activities/endpoints#preview-a-marketing-activity). The defaults are desktop and mobile. |
| `[extensions.fields]`<br><span class="heading-flag">Required</span>| The fields used to define the marketing activity form tha's displayed to merchants in the Shopify admin. For a complete reference on the available fields, refer to [marketing activities components](/docs/api/marketing-activities/components) |


## Step 3: Migrate your extension

After you've imported the extension, you can migrate your extension by using Shopify CLI's `deploy` command.

> Note:
> Deploying extensions using the `app deploy` command also publishes the extensions. We recommend testing changes by using [`app dev`](/docs/api/shopify-cli/app/app-dev) or deploying to a test app before deploying them to a production app.

Use Shopify CLI to deploy your extensions:

1. Navigate to your app directory.
2. Run the following command to start deploying your extensions:

```bash
#!/bin/bash
shopify app deploy
```

3. Follow the prompts.

When you receive confirmation that the deploy was successful, your extensions have been released.