Skip to main content

Shopify Integration

How to connect and use Gradual's Shopify Integration

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 Integrations page, listing the available integrations with their setup and remove controls.

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.

Shopify's admin with the Apps menu open and App and sales channel settings highlighted.
Shopify's Apps and sales channels page with the Develop apps button highlighted.

Once your app is created, you can find the API credentials under the API Credentials tab.

A Shopify custom app's configuration page, with the Configuration and API credentials tabs and the Admin API scopes.

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.

The Integrations page with the Shopify card and its Remove button.

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.

The Rewards page, listing synced Shopify products with their point cost, source, access and listed or unlisted status.

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.

The Contributors page with featured contributors, a leaderboard and the member's own points panel.

The reward redemption confirmation email, listing the order number, item, points redeemed, time and shipping address.

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.
​

The Redemption Orders page, listing each redeemed reward with who redeemed it and their contact details.

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?