---
title: app config link
description: >-
  Pulls app configuration from the Developer Dashboard and creates or overwrites
  a configuration file.
source_url:
  html: 'https://shopify.dev/docs/api/shopify-cli/app/app-config-link'
  md: 'https://shopify.dev/docs/api/shopify-cli/app/app-config-link.md'
api_name: shopify-cli
---

# app config link

Pulls app configuration from the Developer Dashboard and creates or overwrites a configuration file. You can create a new app with this command to start with a default configuration file.

For more information on the format of the created TOML configuration file, refer to the [App configuration](https://shopify.dev/docs/apps/tools/cli/configuration) page.

#### Flags

The following flags are available for the `app config link` command:

* **--auth-alias \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_AUTH\_ALIAS**

  Alias of the Shopify account to use for authentication.

* **--client-id \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_CLIENT\_ID**

  The Client ID of the remote app to link. Use --file-name to specify the destination configuration file. Required if non interactive.

* **--file-name \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_APP\_CONFIG\_FILE\_NAME**

  The name of the app configuration file to create or overwrite. Requires --force to overwrite an existing file.

* **--force**

  **env: SHOPIFY\_FLAG\_FORCE**

  Overwrite an existing configuration file without prompting.

* **--json-schema**

  **env: SHOPIFY\_FLAG\_JSON\_SCHEMA**

  Print the command's JSON schemas.

* **--no-color**

  **env: SHOPIFY\_FLAG\_NO\_COLOR**

  Disable color output.

* **--no-input**

  **env: SHOPIFY\_FLAG\_NO\_INPUT**

  Disable interactive prompts and browser authentication.

* **--path \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_PATH**

  The path to your app directory.

* **--reset**

  **env: SHOPIFY\_FLAG\_RESET**

  Reset all your settings.

* **--verbose**

  **env: SHOPIFY\_FLAG\_VERBOSE**

  Increase the verbosity of the output. May include sensitive data.

* **-c, --config \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_APP\_CONFIG**

  The name of the local app configuration to read and overwrite. Use --file-name instead when specifying --client-id.

### Examples

* #### App config link

  ##### app config link

  ```sh
  shopify app config link [flags]
  ```

***