Volusion Mobile Commerce Troubleshooting Guide

If you're having difficulty setting up and using Volusion Mobile Commerce, these troubleshooting tips will help guide you through resolving the most common issues.

Please be aware that the recommended solution in all cases is to switch to a responsive template, which renders the Mobile Commerce feature obsolete. If you choose to continue using the Mobile Commerce feature with a legacy non-responsive template, you can find alternative solutions below.

I’ve enabled Mobile Commerce, but the mobile version of my store does not display when I access it on a compatible device.

By default, the homepage of both your desktop storefront and your mobile storefront is the /default.asp file. Some merchants choose to override the /default.asp file with the /default.htm file (at Design > File Editor) to create a special landing page or splash page. This configuration, however, is not compatible with Volusion Mobile Commerce. To resolve this issue, you must clear the /default.htm content so that the mobile storefront displays your /default.asp file.

I uploaded a logo for the Mobile Storefront, but it looks distorted.

The logo should be .jpg, .gif, or .png file type, with a recommended size of 200 x 100 pixels. Larger images are scaled down to these dimensions, which may cause the logo to appear distorted depending on its original proportions. Smaller logos are not scaled up, and display at the original uploaded size.

Nothing shows up when I view my site on a mobile device.

You may have previously entered content into the /mobiledefault.htm file, which creates an intermediate splash page to introduce your mobile storefront. If there is any content at all in your /mobiledefault.htm file, this page will appear rather than your category list. 

To ensure your customers can access the storefront category list after seeing the splash page, be sure you have manually added a link on the page that points to /mobile.aspx. For example:

<a href="/mobile/default.aspx">Shop Our Mobile Site</a>

You can access the /mobiledefault.htm file by going to Design > File Editor in your Admin Area.

My mobiledefault.htm splash page is not appearing when I view my site from a mobile device.

In order for your mobile splash page to appear on a mobile device, you must include the following URL somewhere in the /mobiledefault.htm file:

<a href="/mobile/default.aspx">Shop Our Mobile Site</a>

Replace "Shop Our Mobile Site" with your preferred text. You can also use HTML to attach the link to an image or button on your splash page.

My mobiledefault.htm splash page is not appearing when I click Preview from Design > Mobile.

When previewing the Mobile Storefront from a desktop computer, the mobiledefault.htm splash page is ignored. To view the splash page, visit your store's URL on a compatible mobile device or add the following path after your store's domain name in the URL bar:


I don't recognize what I'm seeing - it's just one list of categories.

Your Mobile Storefront presents a streamlined and simplified version of your category list. It extracts any categories that contain products, and displays them alphabetically or by category Display Order (if specified). If you have hardcoded categories or use nonstandard methods for associating categories and products, this may result in duplication of categories.

Please see the Notes section of the main Volusion Mobile Commerce article for more information about category display.

Product pages that should show multiple child products are showing up as a single product priced at $0.00.

This may be because you have products set up using Multi-Child Add To Cart. This capability is not available with Mobile Commerce.

Please see the Notes section of the main Volusion Mobile Commerce article for more information about product display.

I'm getting a screen filled with long, complex error messages.

If the following text:

Conversion failed when converting the varchar value 'x' to data type int.

appears somewhere in the first few lines, you have entered an unexpected value in a field, either by importing data via CSV or by entering data in table view. Note that x can be any character in this example. Check any data you have recently have entered this way.

I receive a pink-shaded Error 500 when accessing my mobile store.

Make sure you have a default currency configured for your store under Settings > Currency.