Add configuration to your location rule function

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

• Create a metafield definition.
• Add metafields to your GraphQL input query.
• Use metafield values in your function logic.

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

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

For security reasons, it's recommended to create a metafield definition under a reserved namespace. The Shopify admin requires additional permissions to handle reserved namespaces in order to broker metafield changes on behalf of your application.

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

Your code should look like this:

After you create the metafield definition, you can update your function to use metafield values set by the user.

Update your input query to request a metafield value on the created location rule, which is the function owner for this function API. You can then use that value in your function logic.

1. Navigate to your function in extensions/location-rule.

2. Replace the code in the src/run.graphql file with the following code.

   This update to the input query adds a metafield from the locationRule object, which is the function owner.

   The query differs slightly in JavaScript and Rust due to code generation requirements.

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.

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

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