Skip to main content

Shopify Integration

How to connect and use Gradual's Shopify Integration

Updated this week

Gradual’s Shopify integration enables you to sync your Shopify Store products into the Gradual rewards center. Members can then use their reward points in your Gradual Community to redeem items fulfilled through your Shopify Store.

Setting up the Integration

Before beginning, make sure you have an active Shopify Store with products created. Once your store is set up, head into Gradual and go into the ‘Integrations’ tab. When you click on the ‘Setup’ button on the Shopify integration, you will be prompted to enter some information required for the integration on the right-hand side.

The information required is your Store Name, API Secret Key, and Admin Access Token. To find these credentials, head to your Shopify admin panel. Then you'll need to navigate to Settings > Apps and sales channels > Develop apps and then create Gradual as a custom app. Once your app is created, you can find the API credentials under the API Credentials tab.

Gradual only currently supports connecting one Gradual community to one Shopify store. If you have multiple Gradual communities, you will need to connect different Shopify Stores for each.

Syncing Products from Shopify

When Shopify is connected, you can edit the integration to add products. When you click the three dots and then click on ‘Edit’, a menu will open on the right-hand side. You will see all of the products you currently have added, and the option to add more products in the top right-hand corner.

When you click the ‘+Add’ button in the top right, you will see a list of all of your products from Shopify. You can select which products you want to sync into Gradual from here, then click the ‘Add’ button in the bottom right to save the products in the Gradual system. You are able to delete items after they have been added using the trashcan icon.

Two things to keep in mind:

-Product variants are imported as distinct entries in Gradual. For example, a t-shirt offered in two colors and three sizes will generate six unique items corresponding to each combination.

-Gradual does not import quantity data. Inventory is shown only as ‘Available’ or ‘Unavailable’.

Adding Items as Rewards

To make the items you’ve added visible in the rewards center, head into the ‘Contributions’ tab and then go into the ‘Rewards’. Here you will be able to see the products you just selected after connecting your Shopify integration. By default, all new products added from Shopify will show as ‘Unlisted’. You can edit the product by clicking on it, and list it using the toggle found in the top-right hand corner.

Editing the Product

Click on the product to edit it (shown above). When you edit the product you are also able to change the photo, description, and price. Shipping requirements and inventory cannot be edited as they are synced from Shopify.

Something to note:

-Price is not synced to Gradual because the points system is being used for products here.

Viewing and Redeeming the Products

To view and redeem the products listed, login to your Gradual Community as a member. First go into the ‘Contributors’ tab, then click into ‘Rewards’. Click on the ‘Redeem’ button to use your points for the product. When a product is redeemed, an email confirmation will be sent with full details (found below). If shipping is required, Shopify will send a separate email when the product is shipped.

Viewing and Processing Claimed Products

In Gradual under the ‘Contributors’ tab, head into the ‘Redemption Orders’ subtab to view the Shopify products that have been redeemed with points by members of your community. You will be able to see who it was redeemed by, their information, and the order status.

In Shopify, you can find this transaction in the ‘Orders’ tab. You will be able to fulfill the order in Shopify per usual. When you fulfill the order in Shopify, the status will reflect in the Gradual Dashboard as well. If you process the order via the Gradual Dashboard instead, that will reflect in the Shopify ‘Orders’ tab!

Managing Products

When you delete/archive a product or variant of a product in Shopify, the item will get hidden on the Gradual side as well. These are kept in a separate database in the event you need them restored in Gradual.

If you have any questions as you explore this integration feel free to reach out to the Gradual support team at support.gradual.com.

Did this answer your question?