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

# Settings overview

> Find your way around Settings: personal, workspace, automation, commerce and developer pages, and who can see each one.

**Settings** holds everything that is not day-to-day inbox or campaign work: your own profile and notifications, workspace-wide options, team access, quick replies and tags, shipping and payment rules for the AI agent's checkout, and developer access. Open the workspace menu at the top of the sidebar and choose **Settings**; it opens on **Profile**. The same menu holds **Team members** and **Plan and billing** when your role allows them, plus **Language** and **Sign out**, and it lists your workspaces if you belong to more than one.

## Find a setting

The left column groups the pages. The search box at the top (**Search settings**) filters the list by page name and by common words such as "currency", "invite", "password" or "webhooks", in the language the app is in. If nothing matches you see "No settings match your search". On a phone the list and the page swap places.

Pages you edit in place (**Profile**, **Notifications**, **Communication**, **General**, **Payment** and the webhook section of **API keys and webhooks**) show a bar reading **Unsaved changes** with **Save changes** and **Discard** as soon as you edit something. Nothing is applied until you click **Save changes**. **Team members**, **Shipping**, **Macros**, **Conversation tags** and the key list save each item from its own dialog instead.

## The pages

### Personal

These pages are about you, and every role can open them.

| Page | What it does |
| - | - |
| **Profile** | Your name, email and role, the workspace's business name and time zone, password reset, privacy choices, and leaving a workspace. See [Profile and notifications](https://docs.trypopcorn.ai/settings/profile-and-notifications.md). |
| **Notifications** | Which inbox events alert you, and whether they arrive as a pop-up, a notification on your phone or computer, or with a sound. See [Profile and notifications](https://docs.trypopcorn.ai/settings/profile-and-notifications.md#notifications). |
| **Communication** | Whether Popcorn sends you product updates in-app, by email or on WhatsApp. See [Profile and notifications](https://docs.trypopcorn.ai/settings/profile-and-notifications.md#communication). |

### Workspace

| Page | What it does |
| - | - |
| **General** | Inbox media handling, automatic follow-ups, working hours, product settings (default currency, quantities, custom options), VAT for Zid prices and the Knowledge workspace switch. See [Workspace settings](https://docs.trypopcorn.ai/settings/workspace.md). |
| **Team members** | Invite colleagues, change their role, remove them, and manage pending invites. See [Team and roles](https://docs.trypopcorn.ai/settings/team-and-roles.md). |
| **Roles and permissions** | The five predefined roles and the permission matrix each one grants. See [Team and roles](https://docs.trypopcorn.ai/settings/team-and-roles.md#roles-and-permissions). |

### Automation

| Page | What it does |
| - | - |
| **AI assistants** | Connect ChatGPT, Claude or Codex to your workspace. See [AI assistants](https://docs.trypopcorn.ai/ai-assistants/overview.md). |
| **Macros** | Reusable replies your team inserts in the Inbox with a `/shortcut`. See [Tags and macros](https://docs.trypopcorn.ai/inbox/tags-and-macros.md). |
| **Conversation tags** | Tags with priorities that the AI agent applies on handover and your team uses to filter the Inbox. See [Tags and macros](https://docs.trypopcorn.ai/inbox/tags-and-macros.md). |

### Commerce

| Page | What it does |
| - | - |
| **Shipping** | Shipping options (fee, delivery time, free-shipping threshold) and the countries and cities you deliver to; with Shopify, the delivery coverage. See [Shipping and payment](https://docs.trypopcorn.ai/settings/shipping-and-payment.md). |
| **Payment** | Which payment methods the AI agent may offer at checkout: cash on delivery, bank transfer, payment link. See [Shipping and payment](https://docs.trypopcorn.ai/settings/shipping-and-payment.md#payment-methods). |

### Developer

| Page | What it does |
| - | - |
| **API keys and webhooks** | Create API keys and configure the message-status webhook. See the [API reference](https://docs.trypopcorn.ai/api-reference/introduction.md). |

Plans, credits and invoices are not under Settings. Choose **Plan and billing** in the workspace menu, or click the credits shown under your agent in the sidebar; see [Plans and credits](https://docs.trypopcorn.ai/billing/plans-and-credits.md).

## Who sees which page

A page only appears in the list if your role can view the area it belongs to. **Settings** itself, and the workspace menu, are there for everyone. With the predefined roles:

| Page | Owner, Admin | Manager | Agent | Viewer |
| - | - | - | - | - |
| **Profile**, **Notifications**, **Communication** | Yes | Yes | Yes | Yes |
| **General** | Yes | Yes (view only; saving needs settings edit access) | No | No |
| **Team members**, **Roles and permissions** | Yes | Yes (view only) | Yes (view only) | No |
| **AI assistants**, **API keys and webhooks** | Yes | Yes (view only) | No | No |
| **Macros**, **Conversation tags** | Yes | Yes | Yes | Yes (view only) |
| **Shipping**, **Payment** | Yes | Yes | Yes (view only) | Yes (view only) |

Seeing a page does not always mean you can change it: saving on **General** requires settings edit access, changing shipping or payment requires orders edit access, and inviting or removing teammates requires the matching team-management actions. The full matrix is in [Team and roles](https://docs.trypopcorn.ai/settings/team-and-roles.md#roles-and-permissions).

## Common tasks

| I want to... | Go to |
| - | - |
| Invite a colleague | **Settings → Team members → Invite team members** ([guide](https://docs.trypopcorn.ai/settings/team-and-roles.md#invite-teammates)) |
| Change someone's role | **Settings → Team members**, the **Role** column ([guide](https://docs.trypopcorn.ai/settings/team-and-roles.md#manage-members)) |
| Fix the time zone used by reports and campaigns | **Settings → Profile → Time zone** ([guide](https://docs.trypopcorn.ai/settings/profile-and-notifications.md#profile)) |
| Reset my password | **Settings → Profile → Reset password** ([guide](https://docs.trypopcorn.ai/settings/profile-and-notifications.md#profile)) |
| Get notifications on my phone | **Settings → Notifications → This device** ([guide](https://docs.trypopcorn.ai/inbox/phone-notifications.md)) |
| Stop or start notifications on this phone or computer | **Settings → Notifications → This device** ([guide](https://docs.trypopcorn.ai/settings/profile-and-notifications.md#notifications)) |
| Hold campaigns outside business hours | **Settings → General → Working hours** ([guide](https://docs.trypopcorn.ai/settings/workspace.md#working-hours)) |
| Change the currency the agent quotes | **Settings → General → Products → Default currency** ([guide](https://docs.trypopcorn.ai/settings/workspace.md#products)) |
| Set VAT for Zid prices | **Settings → General → VAT**, which opens the Zid settings when a Zid store is connected ([guide](https://docs.trypopcorn.ai/settings/workspace.md#vat)) |
| Define where you deliver and what it costs | **Settings → Shipping** ([guide](https://docs.trypopcorn.ai/settings/shipping-and-payment.md#shipping-options)) |
| Let customers pay on delivery, by bank transfer or by link | **Settings → Payment** ([guide](https://docs.trypopcorn.ai/settings/shipping-and-payment.md#payment-methods)) |
| Connect ChatGPT, Claude or Codex | **Settings → AI assistants** ([guide](https://docs.trypopcorn.ai/ai-assistants/overview.md)) |
| Create a quick reply or a conversation tag | **Settings → Macros** or **Settings → Conversation tags** ([guide](https://docs.trypopcorn.ai/inbox/tags-and-macros.md)) |
| Create an API key or set a webhook | **Settings → API keys and webhooks** ([guide](https://docs.trypopcorn.ai/api-reference/introduction.md)) |
| Add another store or brand, or leave a workspace | The workspace menu's **Create workspace**, or **Settings → Profile → Leave workspace** ([guide](https://docs.trypopcorn.ai/settings/team-and-roles.md#several-workspaces)) |

## Language

The app itself is available in English, Arabic and Spanish. The switcher is **Language** in the workspace menu, not in Settings; see [Profile and notifications](https://docs.trypopcorn.ai/settings/profile-and-notifications.md#language).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.