Skip to content
Open Ruit

Selling on Shopify with RUIT: full guide

Which keys RUIT asks you for, which app you have to create in Shopify, how it detects sales and why a product is archived when its stock runs out.

Difficulty: Medium 4min read

Shopify connects with keys, never with your password. You create an app of your own inside your own store, give it the permissions you want and paste its two credentials into RUIT. The permissions are still yours and you can withdraw them whenever you like. The step-by-step guide, with the app, its eight permissions and the two keys, is in connecting Shopify.

What will RUIT ask me for?

Three fields, and none of them is your password:

FieldWhat it isWhere it comes from
Shop URLThe domain ending in .myshopify.comYour Shopify admin panel
Client IDYour app’s identifierThe Shopify Dev Dashboard, when you create the app
Client SecretThat same app’s secretThe Shopify Dev Dashboard, when you create the app

The address is the domain ending in .myshopify.com, not the domain you sell under publicly. RUIT is forgiving about copy and paste: it also accepts the address of the admin panel.

What do I have to set up in Shopify?

Two things, and the second is the one people forget most: creating the app with its permissions and then installing it in the store.

The eight permissions

Six are checked when you connect, so if one is missing you find out at once and the error tells you which: reading and writing products, reading and writing inventory, reading locations and reading orders. The other two, reading and writing publications, are not checked, and that is the trap: without them the product is created in your admin panel and does not appear in the store, because nobody published it to the sales channel.

Does the connection expire?

Your keys do not expire. Behind the scenes RUIT works with one-day tokens that it renews by itself, so you never have to touch anything.

What do I need to publish?

A photo, a title, a description, a price and the item’s condition. If you also keep track of stock, the store needs an inventory location: without one, the listing does not go out.

Each listing is one variant. You can declare up to three option axes (size, color and one more) so that the product is created with the right structure from the start.

As for photos, RUIT sends up to 20 MB per image, the most generous limit of any marketplace, in JPG, PNG or WebP.

How does RUIT find out about a sale?

Your store tells it the moment it happens. When you connect, three notifications are registered: product updated, product deleted and new order.

What happens when the stock runs out?

Shopify is the halfway case between deleting and doing nothing: the product is archived. It disappears from the store but still exists and can be recovered. It is only really deleted if you ask for it.

It is also, along with Wallapop PRO, the only place where you can deactivate and reactivate a listing from RUIT without that dragging the rest of your marketplaces along with it.

View as Markdown

Did this article help?