Connecting a Shopify store on Dovetale


Dovetale allows you to turn on or turn off certain groups of Shopify permissions based on the features you want to use. This allows you to customize which Shopify "access scopes" you want to give Dovetale access to. In order to use Dovetale's community features, the platform will require permission to these access scopes.


Each granted Shopify access scope gives Dovetale permission to read or write a specific resource on your Shopify store. For example, the Shopify "read_orders" access scope allows Dovetale to retrieve data for the last 60 days of orders and the "write_discounts" access scope allows Dovetale to create new discount codes for your store.


A full list of all Shopify access scopes, along with the resources they provide access to, can be seen in the Shopify API documentation: https://shopify.dev/docs/admin-api/access-scopes




Discount Code Management
  • Shopify access scopes required
    • read_orders
    • read_discounts 
    • write_discounts
    • read_price_rules 
    • write_price_rules
  • Why does Dovetale need this? 
    • The permission to read/write discount codes and price rules are required to read existing codes and create new codes to share them with members of your community.
    • The permission to read orders and read/write discount codes is required to track orders by discount code to attribute sales to members of your community.


Order Management

  • Shopify access scopes required
    • read_orders 
    • write_order
    • read_discounts 
    • write_discounts
    • read_price_rules 
    • write_price_rules
  • Why does Dovetale need this? 
    • The permission to read/write orders are required to be able to create gift orders for community members and to track order details and fulfillment status.
    • The permission to read/write discounts and price rules is required to send discount codes or gift cards to community members and to track their orders when the discount codes are used.


Page Management

  • Shopify access scopes required
    • read_content
    • write_content
  • Why does Dovetale need this? 
    • These permissions allow Dovetale to create a page on your website which is used to show your customized community page where applicants can apply to join your community.
    • These permissions allow Dovetale to create vanity redirect links so that you can shorten your long referral links to make them easier to share and use.


Script Management

  • Shopify access scopes required
    • write_script_tags 
    • read_script_tags
  • Why does Dovetale need this? 
    • The permission to read/write scripts allows Dovetale to add small scripts to your website.
    • If you want to track affiliate sales through referral links, this permission is required to install our script for tracking referral link clicks and sales.
    • If you want to add a widget to get more applicants, this permission is required to install our script for loading and displaying your customized widget.


Themes Management

  • Shopify access scopes required
    • write_themes
    • read_themes
    • read_content
    • write_content
  • Why does Dovetale need this?
    • In order for Dovetale to create and embed your community page on your Shopify store, we require access to your Shopify themes in order to create an asset for the embed. We use this permission to read_content, and write_content in order to create the page itself. 
    • Dovetale does not modify your existing themes or assets in this process and will not manage your themes in any way without your permission. 


Have additional questions about the permissions that Dovetale requires to help merchants build community? Feel free to contact support@dovetale.com any time!