Wordpress (downloadable)

Last updated Mar 16, 2015

WordPress.org is a very popular and world-wide used content management system (CMS) that provides the simplest and fastest way to start a blog or website. Ecwid is a simple and fast way for you to open an online store right in your Wordpress site.


WordPress offers two solutions for site(blog)-building: self-hosted or downloadable one (it needs you to have your own hosting and server), and hosted platform (WordPress.com). If you’re not sure which one you’re using, please refer to this page WordPress explaining the difference between the two and giving some help tips.

This article contains information and FAQs to work with downloadable self-hosted WordPress.

If you run your site or blog on self-hosted WordPress platform, you can quickly and easily add Ecwid store on any page of your site.  Just install this plugin: http://wordpress.org/plugins/ecwid-shopping-cart/ as a usual plugin via your site administration panel. Check out this page for installation instructions: http://wordpress.org/plugins/ecwid-shopping-cart/installation/

You can also take a look at this video to observe steps to install Ecwid on a Wordpress site:


How to show different store categories on different Wordpress pages?

You may want to create your own store navigation on your Wordpress site so that each of your store categories will reside on a separate Wordpress page. Ecwid plugin supports such a setup. Here is how you can do that:

  • Create a separate Wordpress page for each category (WP admin backend → Pages)
  • Add the following code to each page in the page editor (do not forget to switch it to the TEXT mode):
    <!-- Ecwid code. Please do not remove this line otherwise your Ecwid shopping cart will not work properly. --> [ecwid_script] [ecwid_minicart] [ecwid_searchbox] [ecwid_categories] [ecwid_productbrowser default_category_id="12345"] <!-- Ecwid code end -->

1. In the code above, you should specify category ID in the default_category_id option. The specified category ID should match the ID of category in your store which you want to display on the current page. See also: How to get ID of your product or category?

2. You may want to disable the Ecwid categories menu widget after you create you own store navigation on your site. You can disable the Ecwid categories menu in the Ecwid plugin settings: WP admin backend → Ecwid → Appearance settings → Show horizontal categories

How to embed a single product on a page or post of my site?

In addition to embedding a whole product catalog on your Wordpress site, you can also feature a single product on a separate page or blog post of your site and allow your customers to purchase the product right from that page. You can use [ecwid_product] shortcode for this.

To embed a product on a page or post

  • Open the page or post in the editor in your Wordpress site backend ("Pages" or "Posts" section correspondingly)
  • Add the following code to any place of the page code: [ecwid_product id="12345"]
  • Do not forget to replace 12345 with the actual product ID. See also: How to get ID of your product
  • Save the changes

That's all, the product widget should appear on your site. 

In addition, the [ecwid_product] shortcode supports several parameters that you can use to customize the look of product on your site. Here are them:

1. 'display' defines which elements to show in the product widget and the order in which the elements appear. The following elements are supported:

  • picture
  • title
  • price
  • options
  • qty
  • addtobag

'link' defines whether the picture and title of resulting widget should be linked to the product details page inside the main Store page on your site. Supported values:

  • yes
  • no


[ecwid_product id="12345"]
[ecwid_product id="12345" display="picture title price"]
[ecwid_product id="12345" display="title picture"]
[ecwid_product id="12345" display="picture title addtobag" link="no"]

When I insert the integration code, it shows only some code lines on the page

Most likely, you added the code when Wordpress post code editor was in Visual mode. You should switch to Text mode and try to re-insert the code.

I use Wordpress.com. How can I install Ecwid? 

Sure, you can embed Ecwid on your blog hosted with WordPress.com as well. Please follow instructions from this article: Wordpress (hosted)

I get a PHP fatal error, when I try to install and use WordPress module

Most likely you get this error because you use the old WordPress version.

"Ecwid Shopping Cart" WP module requires WordPress Version: 2.8 or higher, so if you use WordPress 2.7 and lower, you will get an error.

Possible solutions:

  • You can upgrade your blog to the 2.8 or 2.9 branch.
  • You can use Ecwid with your blog without this module. Just use the manual installation and insert an integration code to any page.

I have accidentally deleted my store page in WordPress, what should I do now?

When you install Ecwid plugin for WordPress, it automatically creates a ready-made store page for you (typically located at /store/ slug, but it may differ if you already had the /store/ page prior to installing or if the human-readable URLs are not enabled in your store). This page serves as the main location of your store from now on, and the plugin remembers its location to correctly redirect the customers clicking your minicart or categories anywhere or using product search on any page of your Wordpress site.

 If you have deleted your store page created by the plugin, the following problems may be present in your site:

  1. When a category or minicart is clicked, a 404 - Not Found page is shown
  2. When a product search is performed, a 404 - Not Found page is shown
  3. The plugin's SEO features does not work for your Ecwid shop, because you use manually inserted shop widget on some other page.
  4. The Single Sign On feature may not work even if enabled and properly configured.

To overcome these problems you need to re-create your store page. That's easy:

  1. Login to your WP Admin as administrator
  2. Go to Pages, create a new page that you will use a a store or edit an existing one. Switch the editor into TEXT mode (the grey tab on top) and put the following code into the editor:​
    [ecwid_minicart] [ecwid_searchbox] [ecwid_categories] [ecwid_productbrowser]

  3. Save the changes. That's it. The plugin will find the new page automatically and the mentioned issues should be fixed.

The Ecwid "Sign in" link doesn't appear in my store

Most likely, the issue is caused by the fact that you enabled "Single sign-on" option in the Ecwid plugin in your Wordpress admin backend by entering your SSO secret key there. The 'Single sign on" feature allows your customers to sign into your WordPress site and fully use your store without having to sign into Ecwid. I.e. if a customer is logged in to your site, he/she is logged in to your store automatically, even if he/she didn't have an account in your store before. That could be a very useful option if you have a lot of registered users on your Wordpress site/blog: when purchasing from your Ecwid store on your site, they will be automatically registered and signed in to your store with pre-filled name and email.

When this feature is enabled, Ecwid' does not provide a separate registration/login links, since your site is responsible for the user accounts, hence the absence of Ecwid's sign in link in the storefront. If you rather want your customers to be able to register in your store separately (and to make the Ecwid sign in link appear in your store), you will need to disable Single sign on: to do it just clear the "SSO secret key" field in Ecwid plugin settings in your WP back end.

I want to apply HTML/Javascript modification to my Ecwid store in Wordpress. Where should I put the modification code?

The custom code of a HTML/JS modification (e.g. custom translation or any other modification) should be placed in the HTML code of Wordpress page where your Ecwid store is installed. If you embed Ecwid manually by copying and pasting the code from the Dashboard page of your control panel to your store page, then the JS code needs to be inserted likewise into the HTML source code of that same page (after the Ecwid integration code). On the other hand, if you use our ready Wordpress plugin, it creates a special page for the store. In your WP Admin → Pages it can be usually found as a page entitled 'Store'. You need to go editing the store page, switch your editor to HTML mode (a gray tab on the top right of editable area) and paste the code in there (again, after Ecwid integration code). Then you need to apply the changes by pressing Update button on the right column.

Was this helpful?
Questions? Get help