Was this page helpful?

Configuration of the Contentful CLI

Requirements

General

Your added config parameters are stored in a .contentfulrc.json file in your home directory (~/.contentfulrc.json). The values in this map are used for every command.

The CLI will try to find other .contentfulrc.json files upstream. You can create a .contentfulrc.json file in your current directory to use other stored values for your projects.

Config list

Display a table with all currently used values.

contentful config list

The output should look similar to this:

┌───────────────────────────────────────────┐
│ ⚙  activeEnvironmentId: master           │
│ ⚙  host: api.contentful.com              │
└───────────────────────────────────────────┘

Config add

Add a value to the config file.

contentful config add --management-token <management-token>

The output should look similar to this:

✨  config added successfully

Display a list of all flags/values you can add to the config file.

contentful config add --help

The output should look similar to this:

Usage: contentful config add [options]

Options:
  -h, --help                     Show help                             [boolean]
  --management-token, --mt       Contentful management API token
  --active-space-id, --as        active space id
  --active-environment-id, --ae  active environment id
  --host, --ho                   management host
  --proxy, -p                    Proxy configuration in HTTP auth format:
                                 host:port or user:password@host:port   [string]
  --raw-proxy, --rp              Pass proxy config as raw config instead of
                                 creating a httpsAgent                 [boolean]
  --config                       set all the config options at once

Config remove

Remove a value from the config map.

contentful config remove --management-token

The output should look similar to this:

✨  config removed successfully

Next steps

Not what you’re looking for? Try our FAQ.