---
title: Publishing
description: Publishing your Shop Mini to the Shop app includes a manual review process. You can use the [`submit`](./commands/submit) command to create a submission, which will upload your source code and initiate a review. Once your submission has been approved, your Shop Mini will be made available to users in the Shop app.
api_name: shop-minis
source_url:
  html: https://shopify.dev/docs/api/shop-minis/publishing
  md: https://shopify.dev/docs/api/shop-minis/publishing.md
---

# Publishing

Publishing your Shop Mini to the Shop app includes a manual review process. You can use the [`submit`](./commands/submit) command to create a submission, which will upload your source code and initiate a review. Once your submission has been approved, your Shop Mini will be made available to users in the Shop app.

***

## Requirements

* You have a [Shopify Partners account](https://www.shopify.com/partners).
* You have set up your Mini using the [`setup`](./commands/setup) command.

[![](https://shopify.dev/images/icons/32/pickaxe-1.png)![](https://shopify.dev/images/icons/32/pickaxe-1-dark.png)](https://shopify.dev/docs/api/shop-minis/commands/setup)

[CommandLearn more about the setup command](https://shopify.dev/docs/api/shop-minis/commands/setup)

## Submitting your Mini

Use the [`submit`](./commands/submit) command to submit your code for review.

You'll need to enter a description to tell us what your Shop Mini does and any changes since your last submission. Please provide a video showing an end-to-end flow of your Shop Mini. This will help provide our team with more clarity during the review process.

Your source code will be uploaded for us to review. Once we've reviewed your submission, we'll either approve it or ask you to make some changes.

If it's approved, your Mini will be made available to users in the Shop app when the Shop Team decides to release it.

If it's rejected, we'll provide detailed actionable feedback to assist with your next submission. If you have questions or concerns about the outcome of a review, please talk to the Shop Minis team in the `#shop-minis` channel in the [Shopify Partners Slack Community](https://join.slack.com/t/shopifypartners/shared_invite/zt-sdr2quab-mGkzkttZ2hnVm0~8noSyvw).

Submission requirements

Submissions have a maximum size of 1.5MB and must include a `src/icon.png` file, which should be 1024x1024px and less than 200KB.

### Examples

* #### Submit your Mini

  ##### Default

  ```bash
  npx shop-minis submit [options]
  ```

## Keeping your Mini up to date

Your Mini must use a compatible SDK version to work with the Shop app. You should upgrade your Mini to the latest SDK version:

* **Before making a new submission** - Submissions with outdated SDK versions will be rejected
* **When requested by Shop Minis team** - If we ask you to upgrade due to compatibility issues

Use the [`upgrade`](./commands/upgrade) command to update your Mini to the latest SDK version:

[![](https://shopify.dev/images/icons/32/pickaxe-1.png)![](https://shopify.dev/images/icons/32/pickaxe-1-dark.png)](https://shopify.dev/docs/api/shop-minis/commands/upgrade)

[CommandLearn more about the upgrade command](https://shopify.dev/docs/api/shop-minis/commands/upgrade)

### Examples

* #### Upgrade your Mini

  ##### Default

  ```bash
  npx shop-minis upgrade [options]
  ```

## Checking the status of a submission

Use the [`check-submission`](./commands/check-submission) command to see details about your latest submission.

### Examples

* #### Check the status of a submission

  ##### Default

  ```bash
  npx shop-minis check-submission [options]
  ```

## Cancelling a submission

If you realize there is an issue with the code you have submitted or you change your mind, you can cancel a submission with the [`cancel-submission`](./commands/cancel-submission) command.

This will only work for pending submissions—if we have already reviewed the submission, you'll need to make a new one. Please contact us if we have approved a submission that you later realize includes a bug.

### Examples

* #### Cancel a submission

  ##### Default

  ```bash
  npx shop-minis cancel-submission [options]
  ```

## Updating a submission

It's not possible to update a pending submission. If you'd like to make changes, you'll need to cancel the pending submission and make a new one.

There can only be one pending submission at a time, you cannot line up multiple submissions. You should either cancel and combine the changes into a single submission or wait for the pending submission to be reviewed first.