1. Documentation /
  2. Extensions /
  3. WooCommerce Instagram

WooCommerce Instagram

Now with support for Instagram Shopping. Read more
WooCommerce Instagram allows you to connect your store with Instagram, upload your product catalog to Instagram, create shoppable posts and stories, define product hashtags and showcase how your customers are using your products in your store.

Requirements ↑ Back to top

  • WooCommerce 3.5+.
  • An Instagram account.
  • A Facebook Page.

Installation ↑ Back to top

  1. Download the .zip file from your WooCommerce account.
  2. Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
  3. Install Now and Activate the extension.

More information at Install and Activate Plugins/Extensions.

Connect your store ↑ Back to top

Prepare your Instagram account ↑ Back to top

Before starting to configure and use this extension, it’s necessary to have an Instagram Business account connected to a Facebook Page. If you already have one, you can skip this section and continue with the next one. Otherwise, follow these steps:

  1. Go to Facebook and Create a Page for your Business.
  2. Create a new Instagram account for your business or use your personal account.
  3. Connect the Instagram Account to the Facebook Page.

In order to connect the Instagram Account to the Facebook Page, go to your Facebook Page’s Settings and click Instagram, then log into your Instagram account:

Connect an Instagram account to a Facebook Page
Connect an Instagram account to a Facebook Page

If the account is not an Instagram Business Account, you will be prompted to set up your Business Profile:

Set up an Instagram Business account
Set up an Instagram Business account

Continue through the steps to convert the account to an Instagram Business Account. When you are done, you will have successfully connected the Facebook Page to the Instagram Business Account and you can start using the WooCommerce Instagram extension.

Connect Instagram ↑ Back to top

Once the extension is activated and you have an Instagram Business account connected to a Facebook Page, go to “WooCommerce > Settings > Integrations > Instagram” to proceed to connect your store with Instagram.

Connect Instagram with WooCommerce
Connect Instagram with WooCommerce

Click on the “Login with Facebook” button and log in with the Facebook account in which you created the Facebook Page for your business.

You will be redirected to Facebook to complete the connection.

First, it will ask for the account that will be used, you can continue with your current user if already was logged in or change your account.

Select the user you will be using to connect with Facebook.
Click on “Continue as …” to log in with Facebook and connect your store.

You will see a list of Instagram Business Accounts. Check the account that will be used in your store and press “Next”.

Choose the Instagram Business Account to use in your integration.
Check the Instagram Business Account to use in your store connection.

In the next step, you will see a list of pages available to use with WooCommerce. Check the page that you want to use with your store.

List of pages available to use with WooCommerce. Check the one you want to use with your store.
Check the page to use with your WooCommerce store.

Before the connection is done, you will be asked to select what WooCommerce Instagram is allowed to do. Removing permissions may cause the application to stop working.

Check the permissions requests by the WooCommerce Instagram app
Allow WooCommerce Instagram to access the account and click “Done”.

After accepting the permissions, you will be redirected to your store automatically:

Instagram account connected with the store successfully
Instagram account connected with the store successfully

The last step is to select the Facebook Page connected to the Instagram Business account from the list displayed by the “Facebook page” setting and save the settings.

Optionally, you can also set the other available settings.

If a successful message appears after saving the settings, congratulations!! You’ve connected Instagram with your store and you can start using the extension.

Renewing access ↑ Back to top

After connecting your Instagram account to your store, It will be necessary to renew the access credentials periodically to continue using the Instagram API. But don’t worry, we have automated the process to renew your access credentials and it doesn’t require the intervention of the store owner.

In rare cases, Facebook could invalidate your current credentials (for security reasons, recent changes in its API, strange activity in your account, etc) and it will require to re-connect your Instagram account with your store manually.

Additionally, your access credentials could expire due to large periods of inactivity or a problem with the renewal process. All these cases will be detected by our extension and it will display a notification to the store owner requesting him to re-connect the account manually.

Notice for renewing the access manually
Renew access manually

If you see this notice on your admin screen, just click on the “Renew access” button and follow the steps.

Instagram Shopping ↑ Back to top

Since version 3.0, our extension supports Instagram Shopping, this integration requires some extra steps in order to enable it. If you are interested in this functionality, please, take a look at this tutorial and follow its steps.

Otherwise, if you want to start using the product hashtags and showcase how your customers are using your products, continue reading this article.

Setup and Configuration ↑ Back to top

Once you’ve connected your Instagram account with your store, new settings will appear and you can start the extension set up.

Instagram settings for the product pages
Instagram settings for the product pages

Product settings ↑ Back to top

This section allows you to set up different aspects of the images displayed on product pages. The settings are the following:

  • Number of images: As its name says, sets the maximum number of images to display.
  • Number of columns: The number of columns to distribute the images.
  • Images to display: This option sets the type of images to display. This is the global setting, but it can be configured individually for each product. Continue reading for more info about this option.

Images to display ↑ Back to top

Instagram allows you to fetch two types of images for a hashtag, the most recent images and the top images (The images with more likes, comments, etc).

When fetching the most recent images, Instagram only returns the images published in the last 24h at the moment we make the request. This may cause no new images are retrieved with the request. To avoid displaying an empty image list on product pages, we store the images from previous days and append them to the new ones. This way, we will have enough images to display with each new day.

Combining the recent images from previous days works fine, but, if the first day we set up the product hashtag there are no recent images to retrieve, how we avoid displaying an empty image list? Well, we append the top images at the end to complete the image list.

This is how the extension works by default, but if you want to implement a different behavior, we have defined other options in the setting “Images to display“:

  • Recent images + Top images: Default. Uses the behavior described above.
  • Recent images: Only uses the recent images.  It will append the recent images from previous days if necessary, but it won’t complete the list with the top images.
  • Top images: Always uses the top images sorted by popularity.

As we mentioned before, the type of images to display may be set up individually for each product. That means you can use the option “Recent images + Top images” by default and set a specific product with the option “Top images“.

Add a Hashtag to a Product

To add an Instagram hashtag to a product:

  1. Go to WooCommerce > Products and select a product from the list.
  2. Select the Instagram tab in the Product Data meta box.
  3. Add a hashtag and update the product.
  4. Optional. Set the type of images to display or use the global behavior.

Images tagged with the supplied hashtag are then outputted on the product listing screens in the frontend of your website.

Instagram images with the product hashtag
Instagram images with the product hashtag

Note: The hashtag is not filtered by any account. It shows the images (even from other users) tagged with this hashtag. So, in order to only displays images related to your products, it’s recommended to be as specific as you can when defining the hashtag. A combination of your store name + the product name could be fine.

Customization ↑ Back to top

This is a Developer level section. If you are unfamiliar with code, WordPress hooks, and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our  Support Policy.

This extension uses “WooCommerce Template Files”. So, you can easily customize the HTML markup of the Instagram section on the product pages.

Change images location ↑ Back to top

If you want to change the location where the Instagram images are displayed on your product page, use the following snippet:

// Remove current location.
remove_action( 'woocommerce_after_single_product', 'wc_instagram_product_hashtag' );

// Set the new location to any available hook of the 'content-single-product.php' template.
add_action( '{wc-single-product-hook}', 'wc_instagram_product_hashtag' );

You can paste the code in the functions.php file of your active theme or use an external plugin like Code Snippets for this.

FAQ ↑ Back to top

Why Facebook login? ↑ Back to top

To access the images published by other people and tagged with each product hashtag,  it’s necessary to use the new Instagram Hashtag Search API (older has been deprecated).

This new Instagram API has been built over the Facebook Graph API and it requires logging in with a Facebook account instead of an Instagram account. There is no other way to access this information.

Can I post content to my Instagram account? ↑ Back to top

Our extension doesn’t post any content to your Instagram account or synchronize your current Instagram profile with your store.

Looking for Instagram Shopping? ↑ Back to top

Since version 3.0 our extension is compatible with Instagram Shopping. Please, take a look at this tutorial and follow its steps.

How many hashtags can I use? ↑ Back to top

Unfortunately, there are some limitations imposed by Facebook in the use of the Instagram Hashtag Search API. You can query a maximum of 30 unique hashtags every 7 days.

Our extension cache all the queries results to reduce your quota consumption. So, this limit might be exceeded (although it isn’t guaranteed) past the first 7 days.

If you have more than 30 products and you are experiencing troubles with the hashtags limit, we recommend you to prioritize the products with this feature or share the same hashtag between very similar products.

Can I use a different hashtag per product variation? ↑ Back to top

No, and it isn’t recommended due to limitations explained in the previous question/answer.

Can I change the image size? ↑ Back to top

At this moment, no. The Instagram API only returns the real size of the images. We’re working to create thumbnails with the same aspect ratio for the displayed images.

How do I refresh the product images? ↑ Back to top

In order to improve the performance of your store and not to exceed the quota consumption of the Instagram API, our extension caches the images and the results of the API requests for 24h.

If you want to force a refresh of the images displayed on product pages, you can go to “WooCommerce > Status > Tools > Instagram image transients” and click on the “Clear transients” button.

How to deauthorize our application? ↑ Back to top

If you want to reset the connection between your store and Instagram or you just want to disconnect it. Follow these steps:

  1. Disconnect the account in the “WooCommerce Instagram” settings page.
  2. In your Facebook account. Go to “Settings > Business Integrations” and select the WooCommerce app. After that, click on the “remove” button.

Something doesn’t work properly ↑ Back to top

If you are experiencing an error with our extension that isn’t listed in the Troubleshooting section, feel free to submit us a support ticket explaining your problem. To give you a solution as fast as possible, it will very useful for us if you could attach a screenshot of the error log.

Where can I find the error log? ↑ Back to top

This extension creates a log to store all the errors related to the Instagram API. To find it, go to “WooCommerce > Status > Logs” and select the file “wc_instagram_api_errors“.

Troubleshooting ↑ Back to top

Instagram Business account not found ↑ Back to top

If you receive this error when saving your settings it means that the selected page in the “Facebook Page” setting doesn’t have an Instagram Business account connected to it. Please, go to the Prepare your Instagram account section and review all the steps carefully.

Access credentials expired ↑ Back to top

If you see an admin notice with this message, it means the automated renewal process failed or Facebook forced to re-connect your Instagram account with your store. You only need to click on the “Renew access” button and follow the steps. More info in the “Renewing access” section.

An unexpected error occurred ↑ Back to top

If you see this error during authentication. Probably there was an error related to the Instagram API connection. Please, take a screenshot to the “wc_instagram_api_errors” log and submit us a support ticket with it.

Privacy Policy ↑ Back to top

Check the Privacy Policy of this extension.

Questions and Feedback ↑ Back to top

Have a question before you buy it? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch with the Developer via the Help Desk.


The most customizable eCommerce platform for building your online business.

  • 30 day money back guarantee
  • Support teams across the world
  • Safe & Secure online payment