# Store Settings

Store settings let you configure the core identity, appearance, email delivery, integrations, supported countries, and languages for your store. You can find all settings pages under the **Settings** group in the admin sidebar.

> **Tip:** If you just completed [onboarding](/features/onboarding), you already configured most of these during setup. You can update any of them at any time from these pages.

## General

The General settings page covers your store's identity, physical address, branding assets, and social media links.

![General settings](/features/store-settings/general.png)

### Main section

| Field             | Required | Notes                                                              |
| ----------------- | -------- | ------------------------------------------------------------------ |
| Store Name        | Yes      | Shown in the browser tab, emails, and SEO meta tags                |
| Store Currency    | Yes      | The default currency for prices and checkout                       |
| Store Description | No       | A short summary of your store. Can be generated with AI if enabled |

### Address details

| Field                  | Required | Notes                                    |
| ---------------------- | -------- | ---------------------------------------- |
| Store Address          | No       | Your physical business address           |
| Country                | Yes      | The country where your business is based |
| State / Province       | No       | Appears after selecting a country        |
| City                   | No       | Appears after selecting a state          |
| Postal Code            | No       | Your business postal/zip code            |
| Store Phone            | No       | Public phone number for your store       |
| Customer Support Hours | No       | e.g. "Mon–Fri 9am–5pm"                   |

### Branding & images

Upload your brand assets here. All images accept PNG, JPEG, SVG, or WebP unless noted otherwise.

| Field             | Notes                                                               |
| ----------------- | ------------------------------------------------------------------- |
| Logo              | Your main store logo, displayed in the storefront navbar and emails |
| Favicon           | The small icon shown in the browser tab (accepts ICO, PNG, or SVG)  |
| Auth Banner Image | Background image shown on the sign-in and sign-up pages             |
| Store Icon        | A square icon used for app-like contexts (PWA, mobile bookmarks)    |

### Social media

| Field                    | Notes                                                       |
| ------------------------ | ----------------------------------------------------------- |
| X (Twitter) URL          | Link to your X/Twitter profile                              |
| Facebook URL             | Link to your Facebook page                                  |
| Instagram URL            | Link to your Instagram profile                              |
| TikTok URL               | Link to your TikTok account                                 |
| WhatsApp URL             | Link or phone number for WhatsApp                           |
| Social Media Chat Button | Toggle to show a floating chat button on the storefront     |
| Platform                 | Choose WhatsApp or Instagram as the chat button destination |

Click **Save Settings** when you are done.

## Theme

The Theme settings page redirects you to the **Page Builder** with the theme panel open. From there you can customize colors, fonts, and light/dark mode preferences.

See [Page Builder](/features/page-builder) for full details.

## Email

Configure outbound email so your store can send order confirmations, shipping updates, and other notifications to customers.

![Email settings](/features/store-settings/email.png)

### Email addresses

| Field          | Notes                                           |
| -------------- | ----------------------------------------------- |
| Contact Email  | The public support email shown to customers     |
| No-Reply Email | Used as the sender address for automated emails |

### SMTP configuration

You will need the SMTP credentials from your email provider (Gmail, SendGrid, Mailgun, etc.).

| Field         | Notes                                                |
| ------------- | ---------------------------------------------------- |
| SMTP Host     | Your mail server hostname (e.g. `smtp.sendgrid.net`) |
| SMTP Port     | Usually `587` for TLS or `465` for SSL               |
| SMTP User     | Your SMTP login username                             |
| SMTP Password | Your SMTP login password                             |

> **Tip:** Save your settings first, then use the **Send test email** button to verify your SMTP configuration is working.

> **Important:** SMTP credentials can also be configured through `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, and `SMTP_PASSWORD` environment variables. When an environment variable is set, the matching field in this form is disabled and shows _"Configured by environment variable"_ — the value from the environment takes precedence. See [Docker Deployment](/docker-deployment#optional-smtp-configuration-via-environment-variables) for details.

### Notification customization

Below the SMTP settings you will find eight notification types. Each one can be individually enabled or disabled, and each has a **Custom Text** editor where you can add a personalized message that will appear in the email sent to the customer.

| Notification   | When it is sent                       |
| -------------- | ------------------------------------- |
| New Order      | When a customer places a new order    |
| Paid           | When payment is confirmed             |
| Shipped        | When the order is marked as shipped   |
| Delivered      | When the order is marked as delivered |
| Cancelled      | When the order is cancelled           |
| Returned       | When a return is processed            |
| Refunded       | When a refund is processed            |
| Payment Failed | When payment processing fails         |

## Integrations

Connect optional third-party services to unlock additional features. All integrations are optional — you can skip any of them and come back later.

![Integrations settings](/features/store-settings/integrations.png)

| Integration                 | What it enables                                     |
| --------------------------- | --------------------------------------------------- |
| **Platform Telemetry**      | Share anonymous usage data to help improve Capyshop |
| **AI (OpenAI / Anthropic)** | AI-powered product descriptions and search          |
| **Stripe**                  | Credit card and digital wallet payments at checkout |
| **Google Auth**             | "Sign in with Google" for customers                 |
| **Facebook Auth**           | "Sign in with Facebook" for customers               |

### AI configuration

| Field        | Notes                                                         |
| ------------ | ------------------------------------------------------------- |
| Enable AI    | Toggle to enable AI features across the platform              |
| LLM Provider | Choose between OpenAI (ChatGPT) or Anthropic (Claude)         |
| API Key      | Your provider's API key. Use the **Verify** button to test it |

### Payment provider (Stripe)

| Field           | Notes                                                        |
| --------------- | ------------------------------------------------------------ |
| Enable Payment  | Toggle to enable Stripe payments                             |
| Provider Type   | Currently only Stripe is supported                           |
| Secret Key      | Your Stripe Secret Key (`sk_...`). Use **Verify** to test it |
| Publishable Key | Your Stripe Publishable Key (`pk_...`)                       |
| Webhook Secret  | Your Stripe webhook signing secret (`whsec_...`)             |

### Social login (Google & Facebook)

For each provider, you need to create an OAuth application in the respective developer console and fill in the credentials.

| Field         | Notes                                                                  |
| ------------- | ---------------------------------------------------------------------- |
| Enable        | Toggle to enable the sign-in option for customers                      |
| Client ID     | The OAuth client/app ID from the provider's developer console          |
| Client Secret | The OAuth client/app secret                                            |
| Callback URL  | Displayed as a read-only field — copy this into your provider's config |

> **Note:** Enabling platform telemetry sends anonymous admin panel usage statistics (such as which features you use) and unhandled application errors to the Capyshop team, so the team can fix bugs as they happen in the wild. No personal data, store names, or customer information is ever collected. You can turn it off at any time.

## Countries

Manage which countries your store supports. The countries list determines which options are available in address selectors across the storefront and checkout.

![Countries](/features/store-settings/countries.png)

| Column | Description                                         |
| ------ | --------------------------------------------------- |
| Name   | Country name (sortable)                             |
| Code   | ISO country code (sortable)                         |
| Status | **Active** (available to customers) or **Inactive** |

You can **search** by country name, **filter** by status, and **sort** by any column.

### Bulk actions

Select one or more countries using the checkboxes, then use the bulk actions bar:

- **Activate** — make selected countries available
- **Deactivate** — hide selected countries from customers

You can also toggle individual countries via the **...** menu on each row.

## Languages

Choose which languages your storefront will be available in. At least one language must be enabled — it does not have to be English.

![Languages](/features/store-settings/languages.png)

The available languages are:

| Language   | Locale code |
| ---------- | ----------- |
| English    | `en`        |
| Español    | `es`        |
| Nederlands | `nl`        |
| Português  | `pt`        |

Toggle on any locales you want to support, then click **Save Languages**.

> **Language fallback for visitors.** Server-rendered storefront pages and order emails resolve the locale in this order: a logged-in customer's stored preference, then the visitor's `locale` cookie, then the first language enabled here, finally English. A stale cookie pointing at a language you've disabled will harmlessly fall through to your first enabled language.