WooCommerce Instagram

Due to important changes in the Instagram API. Version 2.0 or higher of this extension is required to make it work correctly. Version 1.x is deprecated.

WooCommerce Instagram allows you to connect your Instagram account and showcase or share how customers are using your products.

Requirements ↑ Back to top

  • WooCommerce 2.4+.
  • 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.

Setup and Configuration ↑ 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.

Accept the requested permissions by the WooCommerce app clicking on the “Ok” button.

Facebook dialog with the WooCommerce app permissions
Accept the WooCommerce app permissions

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 displaying Instagram images by using a hashtag on product listings.

Add a Hashtag to a Product ↑ Back to top

To add an Instagram hashtag to a product:

  1. Go to WooCommerce > Products and select a product to tag.
  2. Select the Instagram tab in the Product Data meta box.
  3. Add a hashtag and update the product.
Add a hashtag to a product
Add a hashtag to a product

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 most recent 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 be able to access the images published by other people and tagged with each products 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 to log in with a Facebook account instead of an Instagram account. There is no other way to access this information. Sorry.

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 be able to create thumbnails with the same aspect ratio for the displayed images.

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 any 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.

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? Please fill out this pre-sales form.

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

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top