Settings overview
Everything that configures how your store behaves — rather than what it sells — lives behind the single Settings item at the bottom of the admin sidebar. It opens a grid of cards, and the first card, General Settings, is itself a page of eleven sub-pages. This article is the map: what each card is for, where the deeper articles pick up, which sub-page holds the setting you are looking for, and a full walk through the two pages that have no article of their own, E-mails (SMTP) and Currencies. It ends with the handful of things people expect to find under Settings that live somewhere else.
1. The Settings page
The cards appear in this order. Cards marked Pro are hidden on TitanCart Lite; cards marked when installed appear only when the relevant extension or theme is present.
| Card | What it is for | Read more |
|---|---|---|
| General Settings | Company details, units, catalogue behaviour, storefront appearance, checkout rules, e-mail sending, security and logging — the eleven sub-pages in section 2. | This article |
| Theme Options (when the active theme provides them) | The storefront theme’s preset and design controls. Changing the preset also re-pins the product image shape under Thumbnails. | Connecting the TitanCart theme |
| Payment Gateways | Enable and configure Stripe, PayPal, Square, Authorize.net, Venmo and the offline methods. | Payment gateways overview |
| Shipping Methods | Shipping methods, rate tables, live carrier rates and the areas they serve. The ship-from address is the Company sub-page of General Settings. | Shipping zones & rate tables |
| Tax Rules | Tax rates by location and tax classes. Whether prices are shown with tax is an Appearance setting; the calculation basis is a Checkout setting (section 2). | Tax rules & destinations |
| Currencies | The store currency and how amounts are formatted. | Section 4 |
| Account & License (Pro) | Your TitanCart Pro key, plan details and activation. | Activating a license key |
| Order Statuses | The order and fulfillment statuses, their colours, e-mails and stock behaviour. | Order statuses |
| Notifications | Which events e-mail customers and administrators, the templates, the documents and a test sender. This is not where the mail server is set up — that is General Settings → E-mails (section 3). | E-mail notifications and templates |
| Customer Fields | Extra questions on the registration form and the customer profile. | Customer fields |
| Import / Export | CSV import and export of products, categories, orders, reviews, waitlists and customers. | — |
| Site Backup (Pro) | Creates, downloads and restores SQL backups of TitanCart’s own database tables and can optimise them. It backs up data only — not your uploads or media files. A download link works for fifteen minutes, for the administrator who asked for it (0.2.79); after that, click Download again. | — |
| API & Integrations (Pro) | API keys, webhooks and the store endpoints for external systems. | — |
| Social Login (Pro) | Sign-in buttons for Google, Apple and Facebook. | — |
| Extensions | A shortcut to Extensions → Installed Extensions. | Installing, updating and removing extensions |
| Marketplace (when installed) | Marketplace mode, branding and the master switch. | Multi-Vendor Marketplace |
| System Logs | The store activity log, filterable by level, type, date and user. What gets recorded is set under General Settings → Logging. | — |
| Download Agreements | Licence text shown to buyers of downloadable products: a store-wide default and per-product overrides, with version history. | Product types |
| Update Center (Pro) | A shortcut to Extensions → Updates. | Installing, updating and removing extensions |
| WooCommerce Migration | Detects a WooCommerce install and transfers its products, orders and customers. | Migrating from WooCommerce |
| TitanCart Essentials (when installed) | The free bundle of mini-features (low-stock urgency badges, a sticky add-to-cart bar and more), each with its own switch. | — |
Not under Settings
- SEO (titles, meta, redirects, robots) — Storefront → SEO.
- GDPR / cookie consent, bot protection, Age Verification, Access Restriction, Product Reviews, Wishlist and the other built-in extensions — each has its own settings card; open Extensions → Installed Extensions and use the gear on its row (the bot-protection row is named Bot Protection (reCAPTCHA / Turnstile) and takes Google reCAPTCHA v2, v3 or Cloudflare Turnstile). Number fields on those cards are checked on Save the same way as the General Settings pages (the end of section 2). See GDPR / cookie consent, Setting up bot protection and Age Verification.
- Languages — there is no Languages page in this release (section 5).
- Maintenance / “coming soon” mode — a TitanCart Essentials feature, not a core setting.
- Loyalty, gift card, newsletter and promotion settings — on their own pages under Growth.
2. General Settings, sub-page by sub-page
Open Settings → General Settings. The left-hand list switches between sub-pages; each has its own Save button at the top right, which confirms with ✓ Saved. Only the sub-page you are on is saved.
- General — Units & Measurement (weight symbol, grams per unit, dimensions unit); Catalog (compare products, track inventory, allow negative stock, downloadable products and the download link lifetime, revoke downloads on refund, low-stock threshold, back-in-stock waitlist e-mails, show products from subcategories, option price modifiers, show out-of-stock products, filter counts); Product Code Generation (auto-generate product codes from name, category, id or a prefix); Promotions (Pro: block a second coupon); Customers (multiple address profiles, group sign-up, administrator must activate accounts, quick registration, the Delete my account button); Search Options (the minimum search query length).
- Appearance — Elements per page for the admin lists (default 50; the lists show between 1 and 100 whatever is saved); Orders per page for My Account (default 10; 1 to 100 in effect); Products per page for the shop and category pages (default 24, a whole number from 1 to 48 — the storefront and the public products API never show more than 48 per page, and since 0.2.79 Save refuses anything else); Number of columns in the product list (1 to 6); Pagination style (Numbered pages, Infinite scroll or a “Load more” button) and Display the “Pagination” section on top of the list, off by default, which adds a second row of page numbers above the grid in numbered mode — since 0.2.81 both rows show the first and last page and two either side of the current one, with … for the gaps, and wrap on a narrow screen, where earlier every page number was listed in one row that grew with the catalogue; quick view, sorting options and default sort; prices shown with or without tax on catalogue and cart pages; product page layout, tabs, gallery and video options; the Display track my orders section switch; the store’s date format, time format and time zone (TitanCart’s own, used across the admin, storefront, e-mails and the printable invoice and packing slip); and the Product Ribbons (Sale, New, Featured, Best Seller, Top Rated, stock badges and Preorder, each with label and colour). The three Available view switches (Grid / List / Compact) and Product list default view are present but not read by the storefront yet. An older Elements per page field for the storefront, which nothing read, was removed in 0.2.79.
- Page Header — the hero or compact banner on storefront pages: style, breadcrumb, alignment, default image, height and overlay, with overrides per storefront page and per top-level category.
- Company — your store’s name, address, phone, website and year, used in the storefront footer, e-mail footers and as the ship-from address for shipping rates; and the Department E-mail Addresses (users, site administrator, orders, support, newsletter reply-to). The company name is also the From name on every e-mail, and the Order department address the default From address — see E-mail notifications section 5.
- Checkout — guest checkout on or off, the post-order “create an account” offer, the order number prefix and starting number, zero-price behaviour, store-wide quantity limits, the tax calculation basis, minimum order amount, shopping for signed-out visitors, shipping estimates on the cart, ship-to-billing rules, Google Places address autocomplete, a default customer location for estimates, and the optional “How did you hear about us?” question. There is no terms-and-conditions checkbox setting.
- Order Automation — the clean-up of abandoned unpaid orders and the payment reconciliation checks: how long to keep checking an unpaid order, how far back to look, and how long to watch an authorised payment. “Keep checking unpaid orders for” cannot be shorter than “Cancel after”; the page refuses the save and says so, with both values.
- E-mails — how mail leaves the server. Section 3.
- Thumbnails — the maximum upload size, JPEG quality, WebP conversion and the product image shape (tall, square or wide; the theme preset can re-pin it).
- Security — force HTTPS on the storefront and admin, the minimum password length and letters-and-numbers rule, forcing new administrators to change their password, password expiry, and the optional security response headers.
- Logging — the minimum level, retention, backtraces, PHP error capture and the per-event switches that decide what System Logs records (orders placed, edited, deleted and refunded; payments; checkout failures and cart errors; registrations; products and categories created, updated and deleted, low-stock warnings; blocked IPs; backups, restores, optimisations and query errors; outgoing API calls and shipping-rate errors; settings changes). Until the page has been saved once every switch counts as on, and errors are always recorded whatever the switches say.
- Download Agreements — opens the Download Agreements page described in section 1.
How saving works. Values are checked before they are written: a number field refuses text (“…needs a number.”), a decimal where a whole number is required (“…must be a whole number.”) and anything outside its range (“…must be between …”, or “…must be at least …”); the save stops and nothing on the page changes. Since 0.2.80 the settings cards of the built-in extensions (Access Restriction’s attempt counts and block hours, Reviews per page, Emails per batch, Return period and the like) are checked the same way. A value an earlier version let through outside its range is corrected to the nearest allowed value when you update, so the page can still be saved. Every successful save writes a Settings saved line in System Logs. If a sub-page answers “Your session has expired — reload the page and try again.” when you open it, reload and sign in again; a save that fails shows the server’s own message, or Save failed.
3. E-mails: SMTP and how mail is sent
By default TitanCart hands e-mail to the server’s PHP mail function, which works on some hosts and lands in spam or vanishes on others. General Settings → E-mails is where you route it through a real mail account instead. The settings apply to every e-mail WordPress sends from the site, not only TitanCart’s.
- Method of sending e-mails — via php mail function (the default), via SMTP server or via Sendmail. The SMTP and Sendmail cards below are always shown; only the one matching the method is used.
- SMTP host — the server name. Put the port after a colon, for example
smtp.example.com:465. With no port TitanCart uses 587. - SMTP username and SMTP password — the mailbox login. The password is never shown again after saving; the field reads Leave blank to keep current, so an empty password on later saves keeps the stored one. It is stored as entered in the database, so treat database backups as sensitive.
- Use Encrypted Connection — None, SSL or TLS. Most providers want TLS on 587 or SSL on 465. If you choose SSL and leave the port at 587, TitanCart switches it to 465 for you.
- Use SMTP authentication — tick it; almost every provider requires a login. Left unticked, the username and password are not sent.
- Path to sendmail program — only for the Sendmail method; the default is
/usr/sbin/sendmail.
Who the mail comes from. There is no From field on this page. The From name is your Company name (Company sub-page), falling back to the site title; the From address is the Order department e-mail, falling back to the WordPress administration e-mail. Individual notifications can use another department address (the users department for account mails, for example), and the envelope sender is always the order-department address. Providers normally reject a From address that is not on a domain they have authorised, so make the Order department address an address on the SMTP account’s domain.
Test E-mail Delivery. Save first — the test reads the stored settings, not unsaved edits — then enter an address and click Send test email. A sample order confirmation goes out through the live pipeline with the subject prefixed [TEST]. A green result reads “Test email (order_confirmation) sent to … via smtp.”; a red one starts “Failed:” and quotes the mail server’s own error, with the transport in brackets. A failure that says only “wp_mail() returned false” means the server gave no detail; check the host’s mail log. The Notifications page has a second test sender for the other message types and a per-template Send test.
4. Currencies
Settings → Currencies lists the store’s currencies with a PRIMARY badge on the one in use. A new store has US dollars. Each currency has a Name, a three-letter Code (fixed once created), Symbol, Symbol after amount, Thousands Separator, Decimal Separator, Decimal Places and Position, with a live format preview. To change the store currency, add the new one, switch on Primary currency and save; the previous primary stays as an ordinary row. The primary currency cannot be disabled or deleted until another is made primary, and its exchange rate is always 1.
One currency at a time. Prices are stored and shown in the primary currency only. Additional currencies and their Exchange Rate are saved but not applied anywhere yet: there is no currency switcher on the storefront and no conversion at checkout. Treat the extra rows as preparation for a future release, not as multi-currency selling. Payment gateways charge in the primary currency; make sure your gateway account accepts it.
5. Languages
TitanCart has no Languages page in this release. The storefront follows the WordPress site language, or the current language of WPML or Polylang when one of those is installed, and product and category texts are stored per language code behind the scenes. There is no TitanCart-provided language switcher; use the translation plugin’s.
6. TitanCart Lite and Pro
Lite has the same Settings grid without Account & License, Update Center, Site Backup, API & Integrations and Social Login, and without the Promotions card on the General sub-page. Every other sub-page, including E-mails and Currencies, is identical. See TitanCart Lite.
Troubleshooting
- I cannot find the SMTP settings. They are not on the Notifications card. Open General Settings and choose E-mails in the left-hand list.
- The test e-mail fails with an authentication error. Tick Use SMTP authentication, re-enter the password (it is blank on screen by design) and check the encryption / port pair your provider documents.
- The test succeeds but order e-mails bounce. The From address is not one the provider allows. Set the Order department address (Company sub-page) to an address on the SMTP account’s domain.
- Products per page refuses my value. It must be a whole number from 1 to 48; the storefront never shows more than 48 products on a page.
- The shop’s page numbers run off the edge on phones. Before 0.2.81 the shop listed every page in one row; update, and the row shrinks to the first, last and nearby pages and wraps (Appearance, above).
- I added a currency and customers still see dollars. Expected (section 4): only the primary currency is used.
- A sub-page says the session has expired. Reload the admin page and sign in again, then make the change afresh.
See also
- Store setup checklist — the settings to complete before launch, in order.
- Admin dashboard tour — where everything else lives in the sidebar.
- E-mail notifications and templates — the Notifications card and the department addresses.
- Order statuses — the Order Statuses card.
- Customer fields — the Customer Fields card.
- Managing customers — the Customers block of General Settings in practice.