Getting started with building a discounts experience

In this tutorial, you'll learn how to do the following tasks:

• Generate starter code for Shopify Functions.
• Use GraphQL to define the input of your function.
• Deploy functions to the Shopify platform.
• Use GraphQL to create function owners in a Shopify store.
• Review logs for your function.

• You've created a Partner account.
• You've created a development store.
• You've created an app that uses Shopify CLI 3.0 or higher, or you've migrated your existing app so that it's compatible with Shopify CLI 3.0 or higher.
• You've installed your app on the development store.

The following requirements are specific to Rust-based development with Shopify Functions.

• You've installed Rust.

  On Windows, Rust requires the Microsoft C++ Build Tools. Make sure to select the Desktop development with C++ workload when installing the tools.

• You've installed cargo-wasi:

To create your product discount function, you can use Shopify CLI to generate a starter function, specify the inputs for your function using an input query, and implement your function logic using JavaScript or Rust.

1. Navigate to your app directory:

2. Run one of the following commands to create a new product discount extension:

3. Choose the language that you want to use. For this tutorial, you should select either JavaScript or Rust.

4. Navigate to extensions/product-discount:

5. Replace the contents of input.graphql file with the following code.

   input.graphql defines the input for the function.

6. If you're using JavaScript, then run the following command to regenerate types based on your input query:

7. Replace the src/index.js or src/main.rs file with the following code.

   This function logic applies a 10% discount to any product variant cart lines with a quantity of two or more.

8. Navigate back to your app root and deploy your app:

   A message from the CLI displays and indicates that your product-discount function is live.

You must request the write_discounts access scope to give your app the permissions it needs to create and update discounts.

1. In shopify.app.toml, located in the root of your app, add the write_discounts scope:

2. Restart your app:

   Use the URL provided by the CLI to open or re-install your app. You should be prompted to accept the new access scope permissions in your store.

To activate your function, you must create a product discount on the store where you installed your app. You can do this using the discountAutomaticAppCreate or discountCodeAppCreate GraphQL mutations.

In subsequent tutorials, you'll use metafields on this product discount to configure your function, and create a user interface so that merchants can configure the function themselves.

1. Install the Shopify GraphiQL app on your store. If you've already installed GraphiQL, then you should do so again to select the necessary access scopes for discounts.

2. Find the ID of your deployed function in the .env file at the root of your app. Your function's ID is the value of the SHOPIFY_PRODUCT_DISCOUNT_ID environment variable that's defined in the .env file.

3. Execute the following mutation and replace YOUR_FUNCTION_ID_HERE with the ID of your function:

   You should receive a GraphQL response that includes the ID of the created product discount. If the response includes any messages under userErrors, then review the errors, check that your mutation and functionId are correct, and try the request again.

1. From your Shopify admin, go to Discounts.

   You should now see the Volume discount that you created. Deactivate or delete all other discounts to ensure that the Volume discount is the only active discount.

   

2. Open your development store and build a cart with a single item in it.

   No discounts should be applied to the cart.

3. Increase the item quantity to two.

   The 10% Volume discount should now be applied to the cart.

4. To debug your function, or view its output, you can review its logs in your Partner Dashboard:

   1. Log in to your Partner Dashboard and navigate to Apps > {your app} > Extensions > product-discount.
   2. Click on any function run to view its input, output, and any logs written to STDERR.

• Add configuration to your discounts experience using metafields.