# Extension settings
URL: https://docs.awellhealth.com/docs/extensions/extension-settings

> For the complete documentation index, see [llms.txt](https://docs.awellhealth.com/llms.txt).



Extension settings are what the person installing an extension fills in inside Awell Studio. They are
also the secure way to handle the secrets and environment variables an extension needs, such as an API
key.

Settings are available in every custom action and webhook the extension defines.

## What each setting declares [#what-each-setting-declares]

A setting declares a key, a label, a description, whether it's required, and whether it's obfuscated.

```typescript
const twilioSettings = {
  apiKey: {
    key: 'apiKey',
    label: 'API Key',
    description: 'Enter your API key',
    obfuscated: true, // set this to true when the setting stores sensitive data
    required: true,
  },
  fromNumber: {
    key: 'fromNumber',
    label: 'From number',
    description: 'The number we will send the message from',
    obfuscated: false,
    required: true,
  },
};
```

## Obfuscate anything sensitive [#obfuscate-anything-sensitive]

Set `obfuscated: true` for anything sensitive: an API key with `obfuscated: false` is visible to anyone
who can view the extension's configuration.

Default to obfuscating unless the value is genuinely public, like a sender phone number.

## Write descriptions for the person installing it [#write-descriptions-for-the-person-installing-it]

The `label` and `description` are the entire interface a customer sees at install time. "Enter your API
key" is fine; "apiKey" is not. Say where to find the value if it isn't obvious.

## Next steps [#next-steps]

**Next:** [Store secrets](/docs/extensions/store-secrets) for how these settings keep secrets out of
extension code.