> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augmental.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# App-specific profiles

Vox knows which app you are in. A profile lets you change its behaviour per app, so
dictating into a terminal does not have to work the same way as dictating into email.

<Info>
  App-specific profiles are available on Mac. They are configured from the **Buttons**
  view; the iPhone and iPad app does not assign profiles to apps.
</Info>

## What a profile can change

Profiles currently change button mappings and the voice commands attached to those
mappings. They do not change vocabulary, punctuation, or dictation formatting.

## Creating a profile

<Steps>
  <Step title="Open Buttons">
    Open Vox and select **Buttons** in the left sidebar. Profiles are configured here,
    not in **Settings**.
  </Step>

  <Step title="Create and select a profile">
    At the top of the Buttons view, open the profile menu and choose **New Profile…**.
    Name the profile and choose whether to start with the stock mappings or duplicate
    another profile. Select a profile from the same menu to configure it, and click
    **Set as default** when it should be used everywhere without an app-specific match.
  </Step>

  <Step title="Assign the profile to an app">
    In the **App-specific profiles** row, click **Assign**, then **Add app**. Choose the
    app and select the profile it should use.
  </Step>

  <Step title="Adjust the settings you want to differ">
    Anything you do not change falls back to your default settings.
  </Step>
</Steps>

## How Vox picks a profile

The profile follows the frontmost app. Switch apps and the profile switches with you,
with no action needed. If no profile matches the app you are in, your default settings
apply.

Profiles are assigned to apps, identified by their application bundle. A browser profile
therefore applies to the browser app, not to an individual website.

## Profiles worth setting up

<AccordionGroup>
  <Accordion title="Terminal or code editor">
    Turn off auto-capitalisation and auto-punctuation. Add your project names,
    function names, and CLI tools to the vocabulary.
  </Accordion>

  <Accordion title="Email">
    Leave punctuation on. This is where you want the most formatting help.
  </Accordion>

  <Accordion title="Slack or chat">
    There is no separate built-in chat profile. Create one only if you want different
    button mappings or voice commands for a chat app.
  </Accordion>
</AccordionGroup>

## Seeing which profile is active

The active profile is not shown while dictating. The default profile is used unless the
foreground app has a specific profile assigned.