Add configuration to your validation

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

• Define what configuration settings will be surfaced to merchants.
• Read and use the merchant-defined values in your function.

• You've completed the Getting started with building validations tutorial.

To make your function reusable, replace hardcoded values in your function with metafield values.

For security reasons, it's mandatory to create a metafield definition under a reserved namespace. Reserved namespaces require additional permissions to work in Shopify admin, so you'll need to request these permissions at app installation time.

To create a metafield definition and grant additional access to the Shopify admin, update your shopify.server.ts file with the following code inside the afterAuth hook:

Your code should look like the following example:

Update your input query to request a metafield value that's owned by your validation. Then, use that value in your function logic instead of the previously hardcoded value.

1. Navigate to your function in extensions/cart-checkout-validation.

2. Replace the contents of src/run.graphql file with the following code:

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

4. Replace the src/run.js or src/run.rs file with the following code:

   This update includes parsing the JSON metafield value, and using values from that JSON in the function logic instead of hardcoded values.

   The JSON includes cart quantity limits for each product.

   This change is automatically reflected as long as you're running dev.

• Build a validation user interface using Admin UI extensions.
• Learn how to use variables in your input query.