Skip to main content

Cart & Checkout setup (X-Cart 5.5.x-5.6.x)

Learn about the general settings affecting your storefront behavior

A
Written by Anna Verbichenko
Updated this week

The Cart & Checkout section of the X-Cart Admin area contains the core settings that control how your storefront’s shopping cart and checkout process look and behave. These settings affect both the visual presentation and the customer experience during key steps of the purchase flow.

You can access these options from Store > Cart & Checkout.

In the sections below, each available setting is described in detail, along with guidance on how it impacts the storefront. Review and update the settings to match your business requirements, then click Save to apply the changes to the storefront.


Cart & Checkout > General

By default, the section opens on the General tab, where you’ll find a set of configurable parameters that apply to the storefront as a whole.

Cart & Checkout > General tab

Checkout Settings

Click to expand for more information.

Checkout type

Use this setting to choose the checkout flow for your store. X-Cart supports two checkout types:


Ask guest user to sign in

When this option is enabled, shoppers who are not signed in are shown a prompt when they click Checkout, offering them the option to sign in to an existing account or create a new one.

When this option is disabled, the prompt is skipped and shoppers are taken directly to the store’s checkout page.

During checkout, if a shopper enters an email address that already exists in the store database, the system recognizes it and suggests signing in to the corresponding account.

Safety & Compliance Settings

Click to expand for more information.

Sell products missing CARB compliance info

Learn more about CARB compliance and this setting.

Free Shipping Note Settings

Click to expand for more information.

Display a note about free shipping

Enable this option to display a note indicating that an order qualifies for free shipping.

Cart Settings

Click to expand for more information.

Next order #

This setting lets you define the order number that will be assigned to the next order. The field displays the current value that will be used for the upcoming order.

You can change this value if needed—for example, to start order numbering from a higher number rather than exposing a low sequential order count to customers. The value you specify must be greater than the current order number.


Next draft #

This setting is available in X-Cart 5.6.x (not in X-Cart 5.5.x). It allows you to define the number that will be assigned to the next draft order. The field displays the current value that will be used when a new draft order is created.

You can adjust this value if needed—for example, to start draft numbering from a higher number or to align it with your internal order management practices. The specified value must be greater than the current draft number.

Draft orders are created by store administrators on behalf of customers, typically when orders are placed offline (for example, by phone or email). For more details, see the article on Draft orders and invoices.


Anonymous Cart TTL (days)

This setting is available in X-Cart 5.6.x (not in X-Cart 5.5.x). Use it to specify the number of days after which stored shopping carts of guest users are considered expired and automatically removed. Leave this field empty to keep carts indefinitely (not recommended).


Registered Cart TTL (days)

This setting is available in X-Cart 5.6.x (not in X-Cart 5.5.x). Use it to specify the number of days after which stored shopping carts of registered users are considered expired and automatically removed. Leave this field empty to keep carts indefinitely (not recommended).


Cart TTL (days)

This setting is available in X-Cart 5.5.x (not in X-Cart 5.6.x). Use it to specify the number of days after which stored shopping carts are considered expired and automatically removed. Leave this field empty to keep carts indefinitely (not recommended).


Minimum allowed subtotal

Use this setting to define the minimum order subtotal a shopper must reach in order to proceed to checkout.


Maximum allowed subtotal

Use this setting to define the maximum allowed order subtotal. Shoppers can proceed to checkout only if their order subtotal is below this value.


Maximum allowed quantity (per product)

Use this setting to limit the maximum number of units of a single product that a shopper can add to the cart in one order. If a shopper attempts to add a greater quantity, only the allowed maximum will be added.

Add To Cart Settings

Click to expand for more information.

Redirect to cart

Enable this option to automatically redirect customers to the cart page after a product is added to the cart.


Force product options selection

Use this setting to require customers to select product options before adding a product to the cart. The following modes are available:

  • Never — Customers can add products to the cart without selecting options.

  • On category listing — Option selection is required when adding products to the cart from category listing pages.

  • On category and product details page — Option selection is required both on category listing pages and on product detail pages.

Terms & Conditions Settings

Click to expand for more information.

Agreement type

Use this setting to define how customers provide consent to your store’s Terms & Conditions during checkout. X-Cart supports the following agreement types:

  • Clickwrap agreement
    Displays an “I accept the Terms & Conditions” checkbox with a link to the corresponding Terms & Conditions page at checkout. Customers must actively confirm their consent (for example, by selecting the checkbox) before placing an order.

  • Browsewrap agreement
    Displays a link to the Terms & Conditions page at checkout without requiring explicit user action. Consent is implied by the customer’s use of the website and progression through the checkout process.


Relative URL

Use this field to specify the relative URL of the static page that contains your store’s Terms and Conditions. This option applies when the page is managed through the Simple CMS add-on (Design > Menus & Pages).

If the field is left empty (for example, if the Simple CMS add-on is not enabled), the system uses the default Terms and Conditions text stored in the ?target=terms language variable. In this case, the text is displayed in a popup during checkout.


Cart & Checkout > Miscellaneous

Cart & Checkout > Miscellaneous tab

Product Display

Click to expand for more information.

How to show out of stock products

Use this setting to specify whether out-of-stock products should be visible to customers on the storefront.

The following options are available:

  • Show in all the sections

  • Show only in categories and search listings

  • Show only in search listings

  • Hide and make them available only via a direct link (default value)


Product variations display mode in product list

This setting applies to the Product Variations add-on.


Default sorting within category

Use this setting to set the default display order for products within a category.

The following formats are available:

  • Recommended: Sorting based on the settings as defined for the category page in the store's Admin area (Catalog > Categories > CATEGORY_NAME > Products).

  • Newest first: Sorting by arrival date.

  • By Price - cheapest first: Sorting by price. Products with the lowest price are displayed first.

  • By Price - cheapest last: Sorting by price. Products with the highest price are displayed first.

  • By Name - A-Z: Sorting by product name, from "A" to "Z".

  • By Name - Z-A: Sorting by product name, from "Z" to "A".

  • Sales [Bestsellers Add-on]: Sorting by popularity. Products with the highest sales volume are displayed first.

  • Rate [Product Reviews Add-on]: Sorting by product rating. Products rated highest are displayed first.


Default sorting within search results

Use this setting to set the default sort order for products listed in search results on the storefront.

If your store uses the default X-Cart product search feature, the list of available options here is the same as for the above setting "Default sorting within category."

If your store’s search is powered by CloudSearch, you do not need to adjust this setting because CloudSearch automatically sets the default sort order for search results based on relevance.


Display "Add to cart" buttons for products in grid view

Use this setting to specify whether products should have "Add to cart" buttons in grid view.

Category Display

Click to expand for more information.

Products per category listing page

Use this setting to limit the maximum number of products that can display on a category page.


Max products per a category page

This setting is available in X-Cart 5.5.x (not in X-Cart 5.6.x). Use it to specify the maximum number of products that your customers can choose to view on a category page.


Default product display mode

Use this setting to choose the default display mode for the product list in your store's catalog. This setting may not be adjustable depending on the design theme being used.


Subcategory listings format

Use this setting to define the presentation of subcategories within categories. The following options are available:

  • List

  • Icons


Hide categories without products

Enable this option to hide categories that do not contain any products from the storefront.

Security Settings

Click to expand for more information.

Number of days to store the last login data

Use this setting to define how long the recent_login cookie remains stored on a customer’s device after they sign in. While the cookie is valid, customers can return to the store without having to re-enter their login credentials.


Allow customers to sign up for membership

Enable this option to display a membership sign-up section on the customer profile details page. Customers can use this section to request membership in a specific group.

Once the profile is saved with the selected membership, the store sends a membership request notification to the administrator by email. The administrator can then review the request and either approve or decline it.


Cart & Checkout > Address Fields

Cart & Checkout > Address Fields tab


Cart & Checkout > Default Customer Address

Cart & Checkout > Address Fields tab


Can't find answers you're looking for?

Email us at support@x-cart.com. We will be happy to help!


Did this answer your question?