Shopify
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
Section titled “Connecting”- In Blackbird, navigate to ‘Apps’ and search for Shopify.
- Click Add Connection.
- Name your connection for future reference e.g. ‘My Shopify connection’.
- In Shopify, create or open an app and configure the Admin API scopes it needs. Make sure to provide
read_localesaccess 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,read_legal_policies. - Copy the store name from the store domain. For example, if your domain is
mystore.myshopify.com, then the store name ismystore. - In Blackbird, choose one of the supported connection methods:
Developer API key: paste theAdmin API access token.Client credentials: paste theClient IDandClient secretfrom the Shopify Dev Dashboard app settings. Blackbird exchanges them for a 24-hour access token automatically.- Click Connect.
- Confirm that the connection has appeared and the status is Connected.
Actions
Section titled “Actions”- Download store Download store’s translatable content, such as the homepage title and meta description
- Upload store Upload store’s translatable content, such as the homepage title and meta description
- 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
Section titled “Articles”- Search articles Search articles with specific criteria
- Download article Download content of a specific article
- Upload article Upload content of a specific article
- Search blogs Search blogs with specific criteria
- Download blog Download content of a specific blog
- Upload blog Upload content of a specific blog
- Search pages Search pages with specific criteria
- Download page Download content of a specific page
- Upload page Upload content of a specific page
Products
Section titled “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
Section titled “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
Section titled “Themes”- Download heme Download content of a specific theme
- Upload theme Upload content of a specific theme
- Search themes Search themes with specific criteria
- 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
Section titled “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
Section titled “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
Section titled “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
Filters
Section titled “Filters”Note: Filters are managed in Shopify’s Search & Discovery app. Set them up there before using the filter actions.
- Search filters Search filters with specific criteria
- Download filter Download content of a specific filter
- Upload filter Upload content of a specific filter
Media images
Section titled “Media images”- Search media images Search media images with specific criteria
- Download media image Download content of a specific media image
- Upload media image Upload content of a specific media image
Store theme app embeds
Section titled “Store theme app embeds”- Search store theme app embeds Search store theme app embeds with specific criteria
- Download store theme app embed Download content of a specific store theme app embed
- Upload store theme app embed Upload content of a specific store theme app embed
Metaobjects
Section titled “Metaobjects”- Search metaobjects Search metaobjects with specific criteria
- Download metaobject Download content of a specific metaobject
- Upload metaobject Upload content of a specific metaobject
Store theme locale content
Section titled “Store theme locale content”- Search store theme locale content Search store theme locale content with specific criteria
- Download store theme locale content Download content of a specific store theme locale content
- Upload store theme locale content Upload content of a specific store theme locale content
Store theme section groups
Section titled “Store theme section groups”- Search store theme section groups Search store theme section groups with specific criteria
- Download store theme section group Download content of a specific store theme section group
- Upload store theme section group Upload content of a specific store theme section group
Store theme settings categories
Section titled “Store theme settings categories”- Search store theme settings categories Search store theme settings categories with specific criteria
- Download store theme settings category Download content of a specific store theme settings category
- Upload store theme settings category Upload content of a specific store theme settings category
Store theme settings data sections
Section titled “Store theme settings data sections”Note: These actions only support vintage themes.
- Search store theme settings data sections Search store theme settings data sections with specific criteria
- Download store theme settings data section Download content of a specific store theme settings data section
- Upload store theme settings data sections Upload content of a specific store theme settings data section
Packing slip templates
Section titled “Packing slip templates”- Search packing slip templates Search packing slip templates with specific criteria
- Download packing slip template Download content of a specific packing slip template
- Upload packing slip template Upload content of a specific packing slip template
Payment gateways
Section titled “Payment gateways”- Search payment gateways Search payment gateways with specific criteria
- Download payment gateway Download content of a specific payment gateway
- Upload payment gateway Upload content of a specific payment gateway
Selling plans
Section titled “Selling plans”Note: Selling plans and selling plan groups are created by apps that support them, such as Shopify Subscriptions. Set them up before using the selling plans actions.
- Search selling plans Search selling plans with specific criteria
- Download selling plan Download content of a specific selling plan
- Upload selling plan Upload content of a specific selling plan
Selling plan groups
Section titled “Selling plan groups”- Search selling plan groups Search selling plan groups with specific criteria
- Download selling plan group Download content of a specific selling plan group
- Upload selling plan group Upload content of a specific selling plan group
Store policies
Section titled “Store policies”- Search store policies Search store policies with specific criteria
- Download store policy Download content of a specific store policy
- Upload store policy Upload content of a specific store policy
Article images
Section titled “Article images”- Search article images Search article images with specific criteria
- Download article image Download content of a specific article image
- Upload article image Upload content of a specific article image
Collection images
Section titled “Collection images”- Search collection images Search collection images with specific criteria
- Download collection image Download content of a specific collection image
- Upload collection image Upload content of a specific collection image
Content
Section titled “Content”Note: These actions support the following content types: collection, metafield, article, blog, page, theme, product, menu, delivery method definition, email template, store theme JSON template, filter, media image, store theme app embed, metaobject, store theme locale content, store theme section group, store theme settings category, store theme settings data section, packing slip template, payment gateway, selling plan, selling plan group, store, store policy, article image, collection image.
- 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
Section titled “Events”Articles
Section titled “Articles”- On article created
- On article updated
- On page created
- On page updated
Products
Section titled “Products”- On product created
- On product deleted
- On product updated
- On product publications added
- On product publications deleted
Locales
Section titled “Locales”- On locale created
- On locale updated
Content
Section titled “Content”Note: These events support the following content types: collection, article, blog, page, product, menu, delivery method definition, email template, store theme JSON template, filter, media image, store theme app embed, metaobject, store theme locale content, store theme section group, store theme settings category, packing slip template, store theme settings data section, payment gateway, selling plan, selling plan group, store, store policy, article image, collection image.
Shopify doesn’t expose an update date for the content types in italic. The ‘Updated at’ output will always be empty for them.
- On content updated
Example
Section titled “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
Section titled “Demo video”Shopify + DeepL + OpenAI: Multilingual Products in Minutes
Feedback
Section titled “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.