You can configure your apps locally with TOML files, then deploy your changes using Shopify CLI.

For more details, refer to App configuration. You can use TOML files with names matching format shopify.app.{config-name}.toml to link your project to multiple Shopify apps.

June 30, 2023 - Hi! I am having trouble with setting up my shopify.web.toml files for my NodeJS project, and I don’t really understand the documentation. It isn’t very clear and concise to me. So, I want my app to run under a frontend…

September 26, 2025 - Hi, I am developing the app using remix and I keep on running into same issue every few days. I create a new partners org, create a store on it, install app and I can change the configurations of the app via UI by going to partners → apps → configurations.

A Shopify example app that creates and enforces tokengated product discounts, written in Node.js - tokengating-example-app/shopify.app.toml at main · Shopify/tokengating-example-app

Gadget will automatically update this production TOML file when a Shopify connection configuration is set in your production environment. Additional shopify.app.<ENVIRONMENT>.toml files will be automatically added to your app when you add a new Shopify connection configuration in Gadget, and ...

February 22, 2024 - Hi All, I’m a newbie Shopify app dev. How do i update app handle from TOML file? In this doc https://shopify.dev/docs/apps/tools/cli/configuration#global mentioned an option “handle” at the same place with “name, cli…

When you generate an app extension, a TOML configuration file named shopify.extension.toml is automatically generated in your app's extension directory.

September 30, 2024 - I have followed the steps explained ... config link” and link the toml file to a new app, and the “shopify app config use” to select the “shopify.app.local.toml” file. Any ideas to why the shopify CLI sa......

Example app for demonstrating authorization/authentication for embedded apps - example-app--embedded-auth--js/shopify.app.toml at main · Shopify/example-app--embedded-auth--js

Shopify app template on Next.js with app directory - shopify-next-app/shopify.app.toml at main · ozzyonfire/shopify-next-app

March 8, 2023 - Hi! I am having trouble with setting up my shopify.web.toml files for my NodeJS project, and I don’t really understand the documentation. It isn’t very clear and concise to me. So, I want my app to run under a frontend…

August 13, 2023 - Hey all, I’m new to Shopify App development. I was following this tutorial, and created my app using the command “npm init @Shopify_77 /app@latest”. I then chose to create an app using Remix. However, when it comes to running “npm run dev”, I always get this error when trying to connect my project to an app: “Couldn’t find shopify.app.toml in [directory]”. When I look, the file is in fact under the directory specified.

# This file stores configurations for your Shopify app.

March 27, 2024 - How do i update app handle from TOML file? In this doc https://shopify.dev/docs/apps/tools/cli/configuration#global mentioned an option “handle” at the same place with “name, client_id” but when I try add this option the result when run “npm run deploy” as below: So, What schema ...

November 12, 2024 - Hi! While setting up my CI/CD pipelines for my Shopify Embedded App, I was wondering if it is possible to interpolate environment variables somehow in the shopify.app.toml file. I find creating a copy/environment a bit…

August 12, 2024 - Hi Guys, Can you please help me with this issue? Thanks TOML file:

February 28, 2024 - We've previously discussed environment variables (stored within .env files), but today we'll delve deeper into managing your app's critical data efficiently. Consider TOML files as "Shopify Owned." The data within these files is often sent to Shopify's servers.