> ## 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.

# Workspace settings

> Configure Settings → General: media handling, auto follow-up, working hours, default currency, product options, Zid VAT and the Knowledge workspace.

**Settings → General** ("Inbox, working hours, products and VAT for your workspace.") holds the options that apply to the whole workspace: how the Inbox treats media, which template is used when a WhatsApp reply falls outside the 24-hour window, the working hours that hold campaigns, the currency and product options your AI agent works with, and VAT handling for Zid prices. Everyone on the team is affected by what you save here.

## Before you start

* You need settings view access to open the page (Owner, Admin, Manager) and settings edit access to change it (Owner, Admin). Without edit access every control is disabled and a banner reads "Only people who can edit workspace settings can change these." See [Team and roles](https://docs.trypopcorn.ai/settings/team-and-roles.md).
* Changes are applied only when you click **Save changes** in the **Unsaved changes** bar; **Discard** reverts them. A successful save reads **Settings saved**. If it fails you see **Couldn't save your settings** and your edits stay on the page.
* If the page can't load you see **Couldn't load these settings** with **Try again**.

## Inbox

The **Inbox** panel ("How the inbox handles media, follow-ups and assignments.") has three settings.

| Setting | What it does |
| - | - |
| **Let the agent handle media messages** | When on, images, videos and documents a customer sends are passed to the agent, which keeps handling the conversation; stickers and GIFs reach it as pictures. When off, "images, videos and files go to your team with the reply below": the conversation leaves the agent and lands in **Unassigned** for your team. Voice notes, locations, button and list replies, catalog orders and address-form responses are handled by the agent whatever this setting is. |
| **Reply to media messages** | Shown while the setting above is off. The text sent to the customer when the agent can't handle a file and the conversation is handed over ("Sent to the customer, then the conversation goes to your team."). Leave it empty to hand over silently. |
| **Auto follow-up** | "Follows up with an approved template within the 24-hour response window." Turning it on reveals **Follow-up template**. |
| **Follow-up template** | An approved WhatsApp template ("Select a template"). On a number running in coexistence with the WhatsApp Business app, when a reply can't be delivered because the customer's 24-hour window has closed, Popcorn sends this template instead. See [WhatsApp coexistence](https://docs.trypopcorn.ai/channels/whatsapp-coexistence.md). |
| **Assignment notifications** | A workspace switch saved with these settings. It does not control your own alerts; those are per person under **Settings → Notifications** (see [Profile and notifications](https://docs.trypopcorn.ai/settings/profile-and-notifications.md#notifications)). |

Only approved templates appear in **Follow-up template**. With auto follow-up on, a save is blocked until you pick one: you see "You don't have an approved template yet." when none is approved, or "Pick an approved template, or follow-ups won't be sent." A template that was selected and is no longer approved shows as "name (not approved)". If templates can't load you see **Couldn't load your templates** with **Try again**; create and submit templates under [Templates](https://docs.trypopcorn.ai/campaigns/templates.md).

The agent's own follow-up messages (how many, after how long, with what instructions) are configured per agent in its **Configuration** tab; see [Capabilities](https://docs.trypopcorn.ai/agents/capabilities.md).

## Working hours

"Set the hours used for business-hours reports and campaign restrictions."

| Setting | What it does |
| - | - |
| **Restrict to working hours** | When on, a campaign launched outside the hours below is held and starts sending at the next **Start**. "When off, campaigns can be sent at any time." |
| **Start** / **End** | Times in the workspace time zone. Overnight ranges such as 22:00 to 06:00 are allowed. |

Under the fields the page says "Times use your workspace time zone:" with the zone name and a **Change it on Profile** link, which opens **Settings → Profile**.

Reports always use these hours for **Median first reply in business hours** and the business-hours column of the conversation export, whether or not the restriction switch is on. If you have never set them, reports assume 09:00 to 17:00. See [Reports](https://docs.trypopcorn.ai/analytics/reports.md).

Working hours do not stop the agent from replying; it answers customers around the clock.

## Products

The **Products** panel ("Currency and product options for your catalog.") has four settings.

| Setting | What it does |
| - | - |
| **Default currency** | The currency used on Home, in shipping fees, and in the price the agent quotes when currency visibility is on. Pick the currency your store sells in; the list shows ISO currencies such as "USD - US Dollar (\$)". |
| **Product quantities** | When on, stock quantities are shown in **Products**, the agent sees the available quantity of each product it recommends, and a product whose stock is 0 is marked inactive when it syncs, is imported or is saved, so the agent stops recommending it. When off, stock is ignored, and active products are sent to your Meta catalog with a placeholder quantity instead of the real stock. |
| **Custom product options** | When on, each product page shows a **Custom options** section where you add fields that collect extra information from customers during checkout, such as a gifter name or engraving text, optionally with an extra price. |
| **Show currency to the agent** | When on, the agent is told that all product prices are in the default currency and mentions it when quoting prices. |

> [!NOTE]
>
> If your workspace still holds an older currency symbol such as \$ (which Zid and Salla catalogs treat as the store's own currency), it shows as its own option until you pick a currency. Saving other changes does not rewrite it.

Saving a change to the currency, quantities, custom options, currency visibility or VAT reloads product data across the app. Catalog behaviour, recommendation weights and the product page are described in [Product catalog](https://docs.trypopcorn.ai/products/catalog.md).

## VAT

The **VAT** panel ("How VAT applies to prices synced from Zid.") depends on whether a Zid store is connected.

* **Zid connected.** The panel reads "VAT is set in your Zid settings": "Your agent reads it from Zid, and you can choose it yourself there." **Open Zid settings** opens the Zid settings dialog on Integrations. The button shows only to roles that can edit settings, and the panel itself only if your role can view integrations. See [VAT for Zid prices](https://docs.trypopcorn.ai/integrations/zid.md#vat-for-zid-prices).
* **No Zid store connected.** The panel offers **Add VAT to Zid prices** ("Turn on only if your Zid store shows prices without VAT.") with **VAT rate (%)**. When it is on, Popcorn adds VAT to every product price and sale price as it syncs from Zid, so the agent quotes the price the customer pays. The page shows the worked example "With 15%, a Zid price of 256.52 is saved in Popcorn AI as 295.00." The rate must be from 0 to 100; otherwise you see "Enter a rate from 0 to 100."

The adjustment is applied at sync time and does not affect Shopify or Salla catalogs. After changing it, use **Resync products** on the Zid integration so existing prices are refreshed.

## Knowledge workspace

People who can edit settings also see a **Knowledge workspace** switch ("Use the new knowledge workspace for articles, drafts and version history."). See [Knowledge](https://docs.trypopcorn.ai/knowledge/overview.md).

## Troubleshooting

| Symptom | Cause and fix |
| - | - |
| Every control is disabled | Your role can view settings but not edit them (Manager). Ask an Owner or Admin. |
| A campaign launched during the day has not started sending | **Restrict to working hours** is on and the current time is outside **Start** to **End** in the workspace time zone. It starts at the next **Start**. Check the time zone on **Settings → Profile**. |
| The agent keeps recommending out-of-stock products | Turn on **Product quantities**, then **Resync products** so stock levels mark them inactive. |
| The agent quotes prices without a currency, or the wrong one | Set **Default currency** and turn on **Show currency to the agent**. |
| Zid prices in Popcorn are lower than in your store | Your Zid store shows prices without VAT. Set VAT in the Zid settings on Integrations, or, with no Zid store connected, turn on **Add VAT to Zid prices** here, enter the rate, save and resync. |
| Customers sending photos are handed to your team every time | **Let the agent handle media messages** is off. Turn it on if you want the agent to handle images and documents. |
| **Save changes** does nothing with auto follow-up on | No approved template is selected. Pick one under **Follow-up template**. |

## Related

* [Profile and notifications](https://docs.trypopcorn.ai/settings/profile-and-notifications.md) for the workspace time zone
* [Shipping and payment](https://docs.trypopcorn.ai/settings/shipping-and-payment.md) for the other checkout-related settings
* [Send a campaign](https://docs.trypopcorn.ai/campaigns/send-a-campaign.md) for how working hours affect a launch
* [Reports](https://docs.trypopcorn.ai/analytics/reports.md) for the business-hours response-time figures
* [Product catalog](https://docs.trypopcorn.ai/products/catalog.md) for stock, custom options and recommendation weights


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