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

# Storefront Settings

> Set up tax, shipping, abandoned-cart recovery, your storefront domain, checkout and payments, order messages, webhooks, and store pages.

## What is this?

**Settings** (shown as **Catalog Settings**) is where you decide how your storefront looks and how customers buy from it — business details, tax, delivery, checkout and payment methods, the messages customers receive, and the content of your store pages. It has ten tabs.

![The Catalog Settings page showing the tabs: General, Tax, Shipping, Abandoned Cart, Storefront, WhatsApp Payment, Address Mode, Messages, Integrations, and Pages](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/catalog-settings-overview.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=01b03ac20b5f276898cdce522d2a5ba8)

> [!NOTE]
>
> Open Settings from a catalog's row on the [Storefront overview](https://wabis.mintlify.site/workspace/catalog/overview.md). Each tab saves on its own, and some settings — such as Domain Setup — have their own save button.

## What can I do here?

* Add your business details shown to customers
* Choose how tax is calculated
* Choose how delivery is charged
* Recover abandoned carts with reminders and an optional discount
* Set your store logo, colors, domain, and payment gateways
* Choose how customers pay through WhatsApp
* Choose how customers give their delivery details, or collect orders from your store
* Edit the order messages customers receive
* Send order events to your own systems with webhooks
* Edit your store's About, Contact, Privacy, Terms, and Refund pages

## How to use it

Go to **Storefront → Settings** and choose a tab.

> [tab] General
>
> Enter your **Business Name**, **Email**, **Phone**, and **GST/Tax ID**, plus your business **Address** — **Street**, **City**, **State**, **Country**, and **Pincode**. These details are shown to customers on the storefront.

> [tab] Tax
>
> Choose how tax is added to orders:
>
> * **No Tax (0%)** — no tax is applied.
> * **Flat Tax (same % for all products)** — applies one fixed percentage to all orders. Enter the **Tax Rate (%)**.
>
>   ![The Tax tab with the No Tax / Flat Tax options](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/catalog-settings-tax.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=95206c174efe99b481d43f3e1c1ec4e2)

> [tab] Shipping
>
> Choose how delivery is charged:
>
> | Mode | How it works |
> | - | - |
> | **Free Shipping** | Free delivery for every customer. |
> | **Flat Rate Shipping** | One fixed delivery fee for all orders — enter the amount, for example 50. |
> | **Pincode-based Delivery** | Set delivery availability and rates per pincode (postal code). Add a rule for each pincode with its rate, and set a **default delivery fee** for everywhere else. |
> | **Amount-based Delivery** | Set delivery fees by order value. Add ranges with a minimum amount, an optional maximum amount, and the rate for that range. |
>
> ![The Shipping tab with the four shipping mode options](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/catalog-settings-shipping.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=72a2a24bac9da9596f97f31e23d087a0)

> [tab] Abandoned Cart
>
> Win back customers who add items but don't finish ordering.
>
> 1. Turn on **Enable Abandoned Cart Recovery**.
> 2. Set **Send reminder after (minutes)** — how long to wait before reminding the customer.
> 3. Set **Max reminders per day**.
> 4. Optionally turn on **Enable Offer Discount** and enter an **Offer Percentage (%)**, such as 10, to tempt them back.

> [tab] Storefront
>
> **Look and feel.** Set the **Store Logo URL**, **Store Description**, and the **Primary Color** and **Secondary Color**.
>
> **Domain Setup.** Choose where your store lives:
>
> 1. Enter a **Storefront URL** — your default address, such as `yoursite.com/store/store-name` — and click **Save URL**.
> 2. To use your own domain, enter it under **Custom Domain (Optional)** — for example `mystore.com` — and click **Add Domain**. Custom domains are available on higher plans; otherwise you'll see **Upgrade Plan**. If custom domains aren't set up on your platform, this section is hidden (unless a domain is already saved).
> 3. Add the **DNS records** shown (Type, Name, and Value — use **Copy**) at your domain provider.
> 4. Wait a few minutes for DNS to update, then click **Verify**. The domain shows **Verified** when it works. A verification checklist tells you exactly what to fix if something is missing.
>
>    ![The Storefront tab's Domain Setup section showing the storefront URL field and custom domain / DNS verification flow](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/catalog-settings-storefront-domain.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=99f423a96b331ebb6d2b7b2c8a0667c3)
>
> **Product Type and payments.** Choose the **Product Type** — **Digital** or **Physical** — which affects the payment methods available. Under **Storefront Payment Gateway**, the **Online payment** section lists the payment accounts you saved once in [Integrations](https://wabis.mintlify.site/workspace/integrations/overview.md) — Stripe and Razorpay. Tick the accounts customers can pay with at checkout. Keys are never entered here: if the list is empty, click **Connect in Integrations**, and click **Manage in Integrations** to change an account. An account that can't take payments yet shows why, for example **Keys missing**, **Publishable key missing** (Stripe card payments) or **Disconnected**.
>
> * **Cash on Delivery (COD)** — lets customers pay when the order arrives
>
>   ![The Storefront Payment Gateway section with online payment accounts and COD](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/catalog-settings-payment-gateway.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=7de73914395267e72981fa264ed7698f)

> [tab] WhatsApp Payment
>
> Choose how customers pay when they order through WhatsApp:
>
> * **WhatsApp Pay** — pay inside WhatsApp. The payment configuration and gateway come from the WhatsApp Pay account saved in [Integrations](https://wabis.mintlify.site/workspace/integrations/whatsapp-pay.md); if none is saved, click **Connect WhatsApp Pay**. Optionally turn on **Enable Expiration** and set **Expires After (minutes)** — an unpaid order is canceled automatically after that time.
> * **Store Checkout Link** — the platform sends a checkout link over WhatsApp, and the customer finishes on your storefront.
> * **Cash on Delivery (COD)** — the customer pays on delivery.
> * **WooCommerce Checkout Link** — send customers to your WooCommerce store. Enter your **Website URL**, then use **Download Plugin** and install the Cart Link plugin on your WooCommerce site (**Plugins > Add New > Upload**). It opens checkout with the cart from the WhatsApp order filled in. No API keys needed.
> * **Shopify Checkout Link** — uses your connected Shopify store (see [Integrations](https://wabis.mintlify.site/workspace/integrations/overview.md)). A draft order is created and its checkout link is sent to the customer. Reconnect Shopify if it was connected before this feature.
>
> These checkout methods are mutually exclusive in most combinations — enabling one turns off the others.
>
> ![The WhatsApp Payment tab showing WhatsApp Pay, Store Checkout Link, COD, and WooCommerce options](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/catalog-settings-whatsapp-payment.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=7f168a3f50e5643bd77767431456b0e9)

> [tab] Address Mode
>
> Choose how customers can give their delivery details after confirming an order. The buttons shown in WhatsApp follow these options. Turn on at least one:
>
> * **Store Pickup** — customers can collect the order from your store. No address or shipping charge is needed; they still pay with the payment option you enabled. When it's on, you can also turn on **Pay at store** — pickup customers get a "Pay at Store" option and pay when they collect. If no other payment method is enabled, the payment step is skipped.
> * **Location Request** — customers share their live location pin on WhatsApp.
> * **Address Form Request** — customers fill in a WhatsApp address form.
>
> If none is enabled, saving shows **Enable at least one address option.**

> [tab] Messages
>
> Customize the messages customers receive as they order. Click **Edit** on any message — changes are saved automatically in the editor.
>
> **Order flow, in the order customers see it:**
>
> 1. **Order Confirmation** — the first message, sent after a customer places an order.
> 2. **Shipping address method** — the customer chooses to **Share Location** (you request their GPS location) or **Share Address** (you request a manual address). The related messages are **2a. Location Request** and **2b. Address Form Request**.
>    * **2c. Store Pickup Confirmation** — sent when the customer chooses Store Pickup. It confirms the order and states it will be collected from the store.
>    * **2d. Order Ready for Pickup** — sent when you set a store pickup order to **Ready For Pickup** in **Update Status** (see [Orders](https://wabis.mintlify.site/workspace/catalog/orders.md)).
> 3. **Payment options** — the message shown depends on your checkout methods:
>
>    * **Checkout link** message (for WhatsApp Pay, COD, Store Checkout, or WooCommerce)
>    * **WhatsApp Pay** message — secure payment inside WhatsApp, which can be combined with COD
>    * **COD confirmation** — sent when the customer picks Cash on Delivery
>
>    ![The Messages tab listing the editable order message templates](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/catalog-settings-messages.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=aafc3d4b6717eb4a2d65a95a26e4f8c3)

> [tab] Integrations
>
> Send order events to your own systems automatically.
>
> * **Order Received** — fires immediately when a new order arrives. Enter a **Webhook URL**, for example `https://your-domain.com/webhooks/order-received`.
> * **Order Update** — fires immediately when an order is updated. Enter a **Webhook URL**, for example `https://your-domain.com/webhooks/order-update`.
>
> Both must be valid **HTTPS** URLs.

> [tab] Pages
>
> Edit the content of your store's pages — a **Page Title** and **Page Content** for each: **About Us**, **Contact Us**, **Privacy Policy**, **Terms of Service**, and **Refund Policy**.
>
> ![The Pages tab showing the About Page editor](https://mintcdn.com/wabis/WS9kn1_MGeoTtoMA/images/catalog-settings-pages.png?fit=max\&auto=format\&n=WS9kn1_MGeoTtoMA\&q=85\&s=7f3eda47d385d1f4188bf9c7f0b442c1)

## Troubleshooting / Technical Notes

* **"Please enter a storefront URL first."** Fill in the Storefront URL before clicking **Save URL**.
* **"DNS Records Required."** The domain was created. Add the DNS records shown, then click **Verify**.
* **"Verification Failed" or "Still Pending."** DNS can take a few minutes to update. Check that the records match exactly, wait, and verify again.
* **"Custom domains are available on higher plans."** Use the default storefront URL, or upgrade your plan.
* **"Enable at least one address option."** Open the **Address Mode** tab and turn on **Store Pickup**, **Location Request**, or **Address Form Request** before saving.
* **Changing one checkout method turned another off.** WhatsApp Pay, Store Checkout, COD, WooCommerce, and Shopify are mostly mutually exclusive. Turn on only the ones you want to combine.
* **"Failed to update settings."** Try again. If it keeps failing, reload the page and check that a channel is selected.

## Related docs

* [Storefront overview](https://wabis.mintlify.site/workspace/catalog/overview.md)
* [Products](https://wabis.mintlify.site/workspace/catalog/products.md)
* [Orders](https://wabis.mintlify.site/workspace/catalog/orders.md)
* [Integrations](https://wabis.mintlify.site/workspace/integrations/overview.md)


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