Configuration

General Settings

The General tab is your starting point. It controls your WhatsApp number, button appearance, and where the button appears on your store.

WhatsApp Number

Enter your WhatsApp number in full international format, without any spaces, dashes, or the + sign. Examples:

• USA: 12125551234
• Portugal: 351912345678
• Brazil (São Paulo, DDD 11): 5511999999999

This is the default number customers will message. You can override it per product category using the Routing tab.

Button Text

ChatCart Pro lets you set a different label for the button depending on where it appears. There are three separate text fields:

• Product Page Button Text: Shown on single product pages. Default: Buy via WhatsApp.
• Cart Page Button Text: Shown on the WooCommerce cart page. Default: Checkout via WhatsApp.
• Checkout Page Button Text: Shown on the checkout page. Default: Complete Order via WhatsApp.

Button Appearance

All ChatCart Pro buttons share a consistent design: a full-width green gradient button with a white WhatsApp icon and bold white label text. This ensures the button is instantly recognizable and visually consistent across all your pages. You can further adjust the button's appearance using CSS in your theme or child theme — the buttons use predictable, well-scoped CSS classes (see the Advanced page for the class reference).

Button Position (Product Page)

Controls where the button is inserted on single product pages, relative to the default WooCommerce “Add to Cart” button:

• After Add to Cart: Displayed below the standard add-to-cart button (default).
• Before Add to Cart: Displayed above the standard add-to-cart button.

Hide Native Buttons

Three optional checkboxes let you hide WooCommerce's native buttons independently:

• Hide Add to Cart button: Removes the WooCommerce “Add to Cart” button from product pages.
• Hide Buy Now button: Removes any “Buy Now” button shown by your theme or WooCommerce.
• Hide Place Order button: Removes the standard WooCommerce “Place Order” button on the checkout page.

Use these when you want WhatsApp to be the sole checkout path.

Show on Product & Cart Pages

Two separate checkboxes control whether the WhatsApp button appears on product pages and the cart page. Both are enabled by default. Disable either one to hide the button from that page type entirely.

Message Greeting & Footer

You can customize the opening and closing lines of the WhatsApp message:

• Message Greeting: The first line of every WhatsApp order message. Default: “Hello! I'd like to place an order:”
• Message Footer: The last line of every WhatsApp order message. Default: “Please confirm my order. Thank you!”

The product details, customer information, payment method, and totals in between are generated automatically — no template tags or custom formatting is required.

Checkout Form Fields

The Fields tab lets you control which pieces of customer information are collected in the ChatCart Pro checkout form before the WhatsApp redirect.

The following fields are available:

Field Labels

Each field has an editable label so you can localize or rename it. For example, you can rename “Postcode” to “CEP” for Brazilian stores, or “Order Notes” to “Observations”.

CEP Auto-Lookup

When the Postcode field is enabled and a customer enters a valid 8-digit Brazilian CEP, ChatCart Pro automatically queries the ViaCEP API and fills in the City and State fields. This reduces friction for Brazilian customers and minimizes address errors.

Payment Methods

The Payment tab lets you define the payment methods available to customers in the checkout form. These are displayed as a visual card grid, and the chosen method is included in the WhatsApp message. Up to 9 payment methods can be added.

Adding Payment Methods

Click the + button to add a new option. Each method has:

• Name: The label shown to customers on the payment card (e.g., “PIX”, “Boleto Bancário”, “Credit Card”, “Cash on Delivery”).
• Icon: An optional image uploaded via the WordPress media library. Displayed on the payment card in the checkout form.
• Enable / Disable toggle: Hide a method temporarily without deleting it.

Reordering Methods

Drag and drop the rows in the Payment Methods table to reorder them. The order here matches the order shown to customers in the checkout form. Put your most popular payment method first.

Removing Methods

Click the trash icon to the right of any method to remove it. The change takes effect after saving.

Disabling Payment Methods

If you don't want to show payment options at checkout, uncheck the Enable payment methods toggle at the top of the Payment tab. When disabled, the payment card grid is hidden from the checkout form entirely.

Floating Button Settings

The Floating tab configures the persistent floating WhatsApp button that can appear on every page of your store — not just product or cart pages. This is covered in detail on the Features → Floating Button page, but the settings are configured here.

Settings Available

• Enable Floating Button: Master toggle. Off by default.
• Position: Bottom-right or bottom-left corner of the screen.
• Show On: Choose whether the button appears on the entire site, product pages only, or the cart page only.
• Mobile Bottom Margin: The distance from the bottom of the screen on mobile devices, in px. Default is 16. Increase this if your theme shows a navigation bar at the bottom of the screen on mobile and the floating button overlaps it — setting it to 70–80 px is usually enough to clear a typical bottom nav bar.
• Pre-filled Message: The message pre-populated in WhatsApp when a customer clicks the floating button. Unlike the product button, this doesn't include an order summary — it's for general inquiries.

Number Routing Settings

The Routing tab lets you map WooCommerce product categories to different WhatsApp numbers. This is useful for stores where different teams or sellers handle different product lines.

When a customer's cart contains products from multiple categories with different routing rules, the number from the first matching item in the order is used. To keep routing predictable, assign products to a single primary category.

For full documentation on how routing works, see Features → Number Routing.