> Agent-readable docs index: /llms.txt. Download /docs.zip to grep all markdown files locally.

---
title: "Shopify App Installation Guide"
---

<Info>
  **The Rye Shopify app currently only works in our Production environment.** Testing your integration with the Shopify app must be done from your Production account, against a store with [test payments enabled](/create-your-own-store).
</Info>

In order for a Shopify merchant to be integrated, they are required to install the Rye Shopify app. Once integrated, developers can leverage the Rye API to access a range of functionalities within the merchant's store, such as managing inventory, processing orders, handling customer returns, etc.

## Rye App Installation

It is a more seamless experience to have Shopify merchants that you work with install the Rye App. This enables the following:

* Live product data updates (inventory, price, etc.)
* Native commission rates

1. Login to Shopify admin and select the store you want to install the Rye app on.

2. Go to the Rye app page [here](https://apps.shopify.com/rye).

<Image style={{borderRadius: "20px"}} src="/_holocron/images/83b82f11-rye_install_page.jpg" alt="" width="3031" height="2181" placeholder="data:image/webp;base64,UklGRlQAAABXRUJQVlA4IEgAAADQAQCdASoQAAwAAsBMJQAAYtTsVMIMYAD++PExxADB01hKC7xdkE4+VhJMZ9pjg2NmAxMd0ZXMjaV/K96N6WgkimbLei9CAAA=" />

3. Click the install button which will redirect you to the app install page.

<Image style={{borderRadius: "20px"}} src="/_holocron/images/7a7dd20c-add-sales-channel.jpg" alt="" width="3050" height="2198" placeholder="data:image/webp;base64,UklGRjwAAABXRUJQVlA4IDAAAACwAQCdASoQAAwAAsBMJaQAAueFWQGAAP7XP/nfwRzodZHlSkyF0LMp5xwo/ckgAAA=" />

4. Click the `Add sales channel` button at the top right.
5. You should land on the `Connect via Rye` page. Click the `Connect` button.

<Image style={{borderRadius: "20px"}} src="/_holocron/images/c54b6fdb-connect.jpg" alt="" width="3036" height="2192" placeholder="data:image/webp;base64,UklGRjIAAABXRUJQVlA4ICYAAACQAQCdASoQAAwAAsBMJaQAAudFrAAA/tc/+B+1bl5d9Lmcy0gAAA==" />

6. After clicking `Connect`, you will be asked to approve the Rye subscription. Select your payment method and click approve.

<Image style={{borderRadius: "20px"}} src="/_holocron/images/561d6b17-approve.jpg" alt="" width="3027" height="2189" placeholder="data:image/webp;base64,UklGRj4AAABXRUJQVlA4IDIAAADQAQCdASoQAAwAAsBMJZwAAueLUQrQAAD+1z/4H7VuYAYaShonpg+7laIUywaw+DiAAA==" />

7. After approving the subscription, you will be redirected to the Rye app dashboard. Here you can do things like update your commission rate.

<Image style={{borderRadius: "20px"}} src="/_holocron/images/e86fe986-rye-app.jpg" alt="" width="3006" height="2184" placeholder="data:image/webp;base64,UklGRjYAAABXRUJQVlA4ICoAAACwAQCdASoQAAwAAsBMJaQAAueF7pdAAP7XP/gf0N+jrEMYTRb8gbAAAAA=" />

## FAQ

#### How much does it cost to use Rye?

* Rye is free to download and install, and there are no monthly subscription fees ($0).
* Commissions are collected via special discount codes, and you are in full control of the commission rate you set. So if you set a 30% commission rate and generate $100 in sales, you’ll receive $70 for the sale while the sales channel charges the shopper $100. We only win if you win.

### Why does Rye require merchants to add a billing method and subscribe to it, even if the Rye app is free?

This is required by Shopify to charge commissions if one is set.

#### Can I adjust my commission rate?

* Yes. The commission rate is adjustable at any time within your Shopify Store, under:
  * **Settings → Apps and Sales Channels → Rye → Open Sales Channel → Default Commission Rate**

#### What can I expect for sales and orders?

* The best way to think about Rye is as a passive sales channel: set and forget. Sales channels are marketing your product for you, and you reap the sales.
  * We’ve had some brands generate 6 figures in 2 weeks, while others are generating a steady 4 figures a month.
  * The best thing you can do to stimulate orders is: set an aggressive commission rate you’re comfortable with to incentivize the sales channels to market your products to their shoppers.

#### Can I choose which of my products is uploaded to Rye and sold on the various e-commerce channels?

* Yes. By default, all products are imported to Rye. You can adjust which products are uploaded at any time through your Shopify Application, however:
  * **Settings → Apps and Sales Channels → Rye → Open Sales Channel → Publishing**
  * New products created will have a checkbox to publish to sales apps like Rye.

#### What are some of the brands that Rye has helped generate sales for?

* We’ve helped hundreds of brands generate sales and revenue, some you may have heard of are:
  * Alo Yoga
  * Auri Nutrition
  * Baboon to the Moon
  * Beauty & the Broth
  * COSRX
  * Fashion Nova
  * Felix Gray
  * Kettle & Fire
  * Kylie Cosmetics
  * L’Oréal
  * Lyfefuel
  * Mojo
  * Princess Polly
  * Sol de Janeiro

#### What level of access does the Rye App have in the Shopify store?

* Visit the [Access Scopes](/sync-api/shopify-merchant-onboarding/shopify-app-access-scopes) page for details.

## Troubleshooting Tips:

#### 404 Page

Sometimes after clicking `Approve` on the app install page, you will be redirected to a 404 page. If this happens, follow the installation flow again and it should work.


---

*Powered by [holocron.so](https://holocron.so)*