When you enter your X-Cart store Admin Home page for the first time after the installation of X-Cart software, you cannot miss the green box that says “Let’s set up your store! - Proceed”. That is the place to start X-Cart’s Quickstart Onboarding Wizard. The Onboarding Wizard is an addon that is aimed to help the store administrator with the initial store configuration and setup. 541-home-onboarding-wizard.png

To start the store configuration process using the Onboarding Wizard, click Proceed.

Onboarding Wizard Welcome

First of all, the Onboarding Wizard will welcome you and provide an outline of the steps that you will need to take to complete your store configuration.


To continue with your store configuration, click Let’s set up your store!. This will take you to the first step of the wizard.

If you don’t wish to use the wizard now, you can close it using one of the buttons:

  • Skip and remind me later - This button will close the wizard so it will not be in your way while you are exploring your store’s Admin area; however, you will be able to access the wizard at any time later via the green “Let’s set up your store!” box.
  • Close and don’t show again - This button will close the wizard for good; the green box will no longer be displayed on the Admin Home page.

Step 1 - Add Your First Product

The wizard will suggest that you should start the store configuration with adding your first product.


If you are not ready to add a product right now, you can skip this step and add products later.

Your newly installed X-Cart store has a pack of demo products that you can use to test the basic store functionality.

You can add your own products later on, and not necessarily by doing it manually one-by-one. The built-in Import-Export tool can help you to add your entire product catalog at once.

If you decide to move on with adding your first product, you will need to name this product, set the product price and upload an image of the product either from your local computer or via URL. (Just tap on the image area to see your options).

This is what this step may look like after all the required product fields have been completed:


If you wish to set more product details (like product weight, description, sale price, etc.), use the “Add other options” link. As a result, the full version of the product details page for the product you are configuring will be opened in a new browser tab. There you will be able to finish configuring the product details and save your changes. Again, you do not have to complete all the product fields right now - you can go back to editing any of the products in your store catalog at any time later. Detailed information on how to create and manage products in your X-Cart store without using the Onboarding Wizard and how to configure all the product fields is available in the section Products and Catalog of this manual.

Let us suppose you have configured all the required product fields at the first step of the Onboarding Wizard to create your first product. Now you can click the button Save and go to the next step.

The wizard will suggest that you take a look at your new product on the storefront.


Note that this page also gives you an opportunity to delete all the demo products that are present in your store. You can do that if you are ready to populate the store catalog with your own products. If not, keep the demo products a bit longer. You may need them to test the basic store functioning.

Click Proceed to the next step to go further.

In Step 2 you can upload your company logo. By a company logo we mean an image representing your business name that is displayed at the top of all the store pages. The store logo serves not only as branding for your site, but it also links back to your store’s home page. quickstart-4.png

Similarly to a product image, your store logo can be uploaded from your local computer or via URL. Tap on the logo area to see the options.

As to the recommended size of your company logo image, you do not have to worry too much about resizing the image to a specific size before upload. With X-Cart, you can upload images larger than needed for display; X-Cart will automatically resize them for optimal user experience. In X-Cart versions 5.4 and later, the size to which your company logo image will be resized can be found (and, if necessary, adjusted) via the image size chart provided in the Images section of your X-Cart store Admin area (Look & Feel > Images). If your store is configured to provide x2 size images for Retina displays (i.e. the setting generate_retina_images in the file etc/config.php of your X-Cart installation is set to “On”), the minimum size of an image you should upload for use as your company logo needs to be twice as large as the size specified in the image size chart. For example, in Crisp White skin, according to the image size chart in the Images section, the size to which your uploaded company logo image will be resized is 221х40 px. This means that to ensure optimal image viewing experience for both your regular screen users and Retina screen users, the recommended size of your company logo image for upload should be at least 442x80 px.

Your store logo will be a part of your company style and will visualize your brand to the site visitors. If you do not have a good selling logo, feel free to ask, and we will be happy to help you with it.

Step 3 - Set Up Your Store Locale and Company Info

In Step 3 you can configure the regional settings to connect your store with local customers and set your company info that will be used to form invoices, send email notifications and calculate shipping rates for your store.

Start with the store locale. The wizard will attempt to name your country, currency and weight unit based on the info that could be derived during the software installation. However, these values may not be correct. You need to verify the information on the screen and make changes, if required.


Should you want to go deeper into configuring the store localization settings, click More localization settings. The wizard will open the Localization page of your X-Cart store Admin area (Store setup > Localization) in a new tab, and you will be able to adjust the localization settings and preferences in more detail.

Once you are happy with your store’s localization settings, click Proceed to the next step so you can move on to adjusting your company information.

On the Company info page, you will need to enter your company name and business address. This information will be included into your customer invoice, and the address will be used as the “from” address for shipping.


After adjusting your company info, click Save and go to the next step to proceed.

Step 4 - Set Up Your Delivery Options

Step 4 of your store configuration is devoted to shipping.

Here you will need to choose whether you are going to sell tangible goods that need to be shipped to the buyer or e-goods/services that are non-shippable.


If you are selling e-goods and services, everything is pretty simple. Click Mark all products as non-shippable, and that’s it! The wizard will set the Requires shipping product setting for all the products in your store to “NO”, and shipping methods will be disabled automatically.

If you are going to sell tangible goods, the process is going to be a bit more complicated. You need to set up shipping options for them. For this purpose, click the Set up shipping button.

You will see a page where you can configure shipping rates for your store:


On this page you can choose between shipping carriers with real-time shipping quotes and your own flat shipping rate that you can create directly on this page (just choose a destination country and set the rate you require, then click the Create shipping rate button). This shipping method will be available at checkout.

For a more detailed shipping setup, click the Advanced shipping options button. The wizard will open the Shipping methods page of your X-Cart store Admin area (Store setup > Shipping) in a new tab where you will be able to configure your shipping methods as you require.

If you choose real-time shipping carriers, click on the carrier logo, and you will be redirected to the carrier service page to set up an account with them.

After configuring your shipping methods, proceed to the last step of this wizard - payments setup.

Step 5 - Set Up Your Payment Methods

Payment methods setup is the last but not the least step of the Onboarding Wizard. quickstart-8.png

X-Cart allows you to choose whether you are going to use an integrated online payment system or process payments offline using your own means.

By default, offline demo payment methods are pre-configured and enabled. They are quite enough to test your new X-Cart store functioning. So if that’s the purpose, leave the present configuration settings as is and Proceed to the next step (complete the store setup with the wizard).

However, if you want to process real orders, you need to configure real payment methods that will work for your customers. Click the Set up offline & online payments button for the wizard to open the Store setup -> Payments page in a new tab. Configure payment methods for your store following the guides of this manual.

Once the payment methods configuration has been completed, you can close the wizard.


Please be aware that the Onboarding Wizard allows you to set up just the very basics of your store configuration. For a more robust store setup, refer to the relevant sections of this manual.