Shopify

View on Github

Shopify is a cloud-based e-commerce platform that enables users to create, customize, and manage online stores. It provides a wide range of features and tools for businesses to sell products and services online, including website templates, payment processing, inventory management, and marketing tools. Shopify allows users to reach customers across different channels, including web, mobile, social media, and marketplaces, making it a versatile solution for individuals, entrepreneurs, and enterprises looking to establish and grow their online presence.

Connecting

1. In Blackbird, navigate to ‘Apps’ and search for Shopify.
2. Click Add Connection.
3. Name your connection for future reference e.g. ‘My Shopify connection’.
4. In Shopify, create or open an app and configure the Admin API scopes it needs. Make sure to provide read_locales access scope. Other scopes that may be needed depending on desired actions are: write_products, read_products, write_publications, read_publications, write_translations, read_translations, read_themes, read_content, read_markets, read_metaobjects, read_metaobject_definitions, write_online_store_navigation, read_online_store_navigation.
5. Copy the store name from the store domain. For example, if your domain is mystore.myshopify.com, then the store name is mystore.
6. In Blackbird, choose one of the supported connection methods:
7. Developer API key: paste the Admin API access token.
8. Client credentials: paste the Client ID and Client secret from the Shopify Dev Dashboard app settings. Blackbird exchanges them for a 24-hour access token automatically.
9. Click Connect.
10. Confirm that the connection has appeared and the status is Connected.

Actions

Store

• Get store locales information Get primary and additional store locales
• Download store resources Download content of all store resource type items
• Upload store resources Upload content of all store resource type items
• Download store content Download content of the store. You should specify what resources you want to export: theme, menu, shop or shop policy.
• Upload store content Upload content of the store

Articles

• Search articles Search articles with specific criteria
• Download article Download content of a specific article
• Upload article Upload content of a specific article

Blogs

• Search blogs Search blogs with specific criteria
• Download blog Download content of a specific blog
• Upload blog Upload content of a specific blog

Pages

• Search pages Search pages with specific criteria
• Download page Download content of a specific page
• Upload page Upload content of a specific page

Products

• Search products Search products with specific criteria
• Download product Download content of a specific product
• Upload product Upload content of a specific product

Metafields

• Download metafields Download metafield content of a specific product
• Upload metafields Upload metafield content of a specific product
• Search metafield definitions Search metafield definitions with specific criteria
• Get metafield Get metafield details of a specific product
• Update metafield Update metafield value of a specific product

Themes

• Download heme Download content of a specific theme
• Upload theme Upload content of a specific theme
• Search themes Search themes with specific criteria

Menus

• Download menu Download content of a specific menu
• Upload menu Upload content of a specific menu
• Search menus Search menus with specific criteria

Delivery method definitions

• Search delivery method definitions Search delivery method definitions with specific criteria
• Download delivery method definition Download content of a specific delivery method definition
• Upload delivery method definition Upload content of a specific delivery method definition

Email templates

• Search email templates Search email templates with specific criteria
• Download email template Download content of a specific email template
• Upload email template Upload content of a specific email template

Store theme JSON templates

• Search store theme JSON templates Search store theme JSON templates with specific criteria
• Download store theme JSON template Download content of a specific store theme JSON template
• Upload store theme JSON template Upload content of a specific store theme JSON template

Content

Note: These actions support the following content types: collection, metafield, article, blog, page, theme, product, menu.

• Upload content Upload content of a specific content type from a file
• Download content Download content of a specific content type
• Search content Search through different content types with specific criteria

Events

Articles

• On article created
• On article updated

Pages

• On page created
• On page updated

Products

• On product created
• On product deleted
• On product updated
• On product publications added
• On product publications deleted

Locales

• On locale created
• On locale updated

Content

Note: These events support the following content types: collection, article, blog, page, product, menu, delivery method definition, email template, store theme JSON template.

Since Shopify does not expose the ‘Updated at’ value for some resources, this output for will always be empty for these content types: menu, delivery method, email template, store theme JSON template.

• On content updated

Example

The following example shows how a bird can be setup so that anytime a Shopify product is updated, we get the locale setup of the online store, download the source content for the updated product as an HTML file, translate the file into all target locales using GlobalLink NOW MT solution and update all target products.

Demo video

Shopify + DeepL + OpenAI: Multilingual Products in Minutes

Play

Feedback

Do you want to use this app or do you have feedback on our implementation? Reach out to us using the established channels or create an issue.