Wordpress (downloadable)

Last updated Nov 27, 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.


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. Please, follow these steps install Ecwid plugin:

  1. In your WordPress admin backend, navigate to Plugins → Add New.
  2. Under Search, type in Ecwid and click Search.
  3. In the search results find the Ecwid Shopping Cart plugin and click Install now to install it.
  4. When plugin is installed click Activate Plugin link.
  5. Navigate to Ecwid Store → General page in your WordPress admin backend and follow the instruction provided there.

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


Once you install the plugin you will be able to add your store to your WordPress site or create a new Ecwid account. So you can create a new store, or connect your existing Ecwid store to the site. The plugin will create a page called Store on your site.

On the next step you can proceed to your store configuration.

Store layout

In the Store setting popup you can choose the widgets that you want to show on your store page. Navigate to the Appearance tab to set the product browser layout:
  • Set the number of products per page for each of the product browser views
  • Choose the category that you want to open by default
  • Set the number of categories per row
  • Choose the default view mode on product pages
  • Choose the default view mode on search results

Sidebar widgets

On Appearance -> Widgets page you can activate the built-in sidebar widgets provided by the plugin:

  • Minicart widget allows you to place a shopping bag icon into your sidebar
  • Search widget allows you to create a search box in the sidebar and let your customers look for the products they want on every page of the site
  • Vertical categories widget is useful when you have a wide sidebar and want to list your store categories there
  • Store page link is a simple link to your store page, which can be very useful when you don't have a pages navigation menu and want to provide your customers with a simple way to open the store page
  • Recently viewed products is a sidebar widget allowing your customers to see what products they visited on your site and return to those product pages. This is a great tool to increase visibility of the store products and generate more sales, because the sidebar is in most cases displayed on every page of the site and thus always visible for the customers. The links and images in the sidebar are updated automatically as the customer browses the store. So the customer can anytime return to the product they previously opened, and probably decide to buy it. 

Manage your store

To add products and categories to the store, setup shipping methods, payment options and manage your orders you need to access your Ecwid control panel. You can do this directly from your WordPress admin area. Go to Ecwid store tab in the menu and click “Open control panel” link.

You can also access your Ecwid control panel via this link: https://my.ecwid.com

Advanced setup

Chameleon skin

Ecwid is designed to automatically adapt to any site structure and screen size to make your store looks good anywhere you add it. However, every site has its own design, especially when it comes to Wordpress with a ton of great themes available. Chameleon skin makes Ecwid fit better to the design of your Wordpress theme. Whatever theme you use, Chameleon detects predominant colors and font and automatically uses them in your product catalog. 

You can enable Chameleon on the "Advanced" tab in the Ecwid plugin settings in your Wordpress backend.
Chameleon is designed to make Ecwid stores on Wordpress adaptive to the site design from the beginning. However, if you already customized your Ecwid CSS theme to make your store look like your site, you probably don't need this new feature. Anyway – feel free to enable it to test the results. If that doesn't work well with your custom design, just untick the Chameleon cheсkbox – you will get no side effects.

Single Sign-On

Automatic login to your store using the “Single Sign-On” tool allows your customers to shop on your site without having to sign in to 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).

To enable this feature, you need to enter a secret key on the Ecwid store -> Advanced page of your WordPress admin backend. You will find this key in your Ecwid control panel, at "System Settings -> Apps -> Legacy API Keys -> Single Sign-On Secret Key" page. This feature is available for paid users only.



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).
  • Click "Add store" button.
  • In the popup specify the widgets you want to show on the page.
  • Use the "Appearance" tab to specify the default category and the categories and products layout.

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"]

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)

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. When 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 (after Ecwid integration code). Then you need to apply the changes by pressing Update button on the right column.

Was this helpful?
Get help