This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Etsy Importer


This plugin will allow you to import your entire Etsy shop’s inventory into WordPress as posts in a Products custom post type. All you have to do is supply an API Key for an Etsy application and the ID of your shop and the plugin will do the rest.

The Etsy Importer will not only import your products but will also:

  • Attach all of the product’s images to the post
  • Set the main product image as the post’s featured thumbnail
  • Add and attach any category added to your product
  • Add and attach any tag added to your product
  • Add the Etsy Product Listing ID, Price, Etsy Product Link, Production Year, and Made For (men/women) meta information to the post
  • Check for new products in your Etsy shop daily and import them automatically once daily. Hands free!
  • Check for existing posts which no longer exist in your shop as active products and set them to draft post status

Not only do we import your products, but we add some shortcodes to help you integrate your products into blog posts.


Display a link to your product – either as a link to the post within your site using the post title as the link text:
[product_link id=569]
[product_link id=569 title=”This is a great new product”]

Or as an external link to your Etsy product page:
[product_link id=569 title=”This is a great new product” external=true]

Display your product’s post content trimmed to whatever length you wish. If no value is set for the length, the full content of the post will be displayed:
[product_content id=569 length=50]

Display your product’s images in a Thickbox gallery using WordPress’ built-in Thickbox jQuery and CSS:
[product_images id=569]
The Etsy Importer allows for the filtering of content throughout the course of posts being imported. Below are the filters available, with details on what they do and how they can be modified.


The default post status your post will be set to when a product being imported is currently ACTIVE.

function your_project_modify_etsy_importer_default_post_status() {

    return 'publish';
add_filter( 'etsy_importer_default_post_status', 'your_project_modify_etsy_importer_default_post_status' );


The post status your existing post will be set to when its corresponding product is currently NOT ACTIVE.

function your_project_modify_etsy_importer_updated_post_status() {

    return 'draft';
add_filter( 'etsy_importer_updated_post_status', 'your_project_modify_etsy_importer_updated_post_status' );


The post arguments passed to update posts when importing products.

function your_project_modify_etsy_importer_updated_post_args( $post_args ) {

    // Always set the post with the ID 45 to publish
    if( 45 == $post_args[ID] ) {
        $post_args[post_status] = 'publish';

    return $post_args;
add_filter( 'etsy_importer_updated_post_args', 'your_project_modify_etsy_importer_updated_post_args' );


The custom post type key.

function your_project_modify_etsy_importer_custom_post_type_key() {

    return 'my_products';
add_filter( 'etsy_importer_custom_post_type_key', 'your_project_modify_etsy_importer_custom_post_type_key' );


The custom post type’s Category key.

function your_project_modify_etsy_importer_category_key() {

    return 'my_category';
add_filter( 'etsy_importer_category_key', 'your_project_modify_etsy_importer_category_key' );


The custom post type’s Tag key.

function your_project_modify_etsy_importer_tag_key() {

    return 'my_tag';
add_filter( 'etsy_importer_tag_key', 'your_project_modify_etsy_importer_tag_key' );


Filter the output of the product link shortcode.

function your_project_modify_etsy_importer_product_link_shortcode( $output, $atts ) {

    // Output a custom value based on the post ID
    if ( 4439 == $atts['id'] ) {

        $output = 'This is my custom output for post ID 4439';


    // Return the output
    return $output;

add_filter( 'etsy_importer_product_link_shortcode', 'your_project_modify_etsy_importer_product_link_shortcode', 10, 2 );


Filter the output of the product content shortcode.

function your_project_modify_etsy_importer_product_content_shortcode( $output, $atts ) {

    // Output a custom value based on the post ID
    if ( 4439 == $atts['id'] ) {

        $output = 'This is my custom output for post ID 4439';


    // Return the output
    return $output;

add_filter( 'etsy_importer_product_content_shortcode', 'your_project_modify_etsy_importer_product_content_shortcode', 10, 2 );


Filter the args passed when displaying a product’s images.

function your_project_modify_etsy_importer_product_images_shortcode_args( $args ) {

    // Limit the number of images displayed to 1
    $args['posts_per_page'] = 1;

    // Return the args
    return $args;

add_filter( 'etsy_importer_product_images_shortcode_args', 'your_project_modify_etsy_importer_product_images_shortcode_args' );


Filter the size of the thumbnail iamge shown when displaying a product’s images.

function your_project_modify_etsy_importer_product_images_shortcode_thumb_size( $atts ) {

    // Use the 'large' image size to display images
    return 'large';

add_filter( 'etsy_importer_product_images_shortcode_thumb_size', 'your_project_modify_etsy_importer_product_images_shortcode_thumb_size' );


Filter the output of the product images shortcode.

function your_project_modify_etsy_importer_product_images_shortcode( $output, $atts ) {

    // Display a different output based on post ID
    if ( 4439 == $atts['id'] ) {
        $output = 'Visit my Etsy shop to view my images.';

    // Return the output
    return $output;

add_filter( 'etsy_importer_product_images_shortcode', 'your_project_modify_etsy_importer_product_images_shortcode', 10, 2 );


Filter the arguments passed when importing your products.

function your_project_modify_etsy_importer_product_import_insert_args( $args, $product ) {

    // Filter the post arguments used when importing your posts
    // In this example, we are adding "My product: " to the beginning of the post title
    $args['post_title'] = 'My product: ' . esc_html( $product->title );

    // Return the output
    return $args;

add_filter( 'etsy_importer_product_import_insert_args', 'your_project_modify_etsy_importer_product_import_insert_args', 10, 2 );


  • In order to import your products, you first need to register an application with Etsy here:
  • Once you have created your app, click “Apps You’ve Made” in the sidebar and select your new app. On the app detail page, copy the value in the Keystring input field. This is your API Key.
  • To retrieve your shop’s ID, begin by visiting the front page of your shop and viewing the source.


  1. Upload the ‘etsy-importer’ directory to the ‘/wp-content/plugins/’ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Visit the plugin settings page (‘/wp-admin/edit.php?post_type=etsy_products&page=etsy_options’) to begin your import.
  4. Enter your Etsy application API Key and your Etsy shop ID and hit the “Save Changes” button to save your information.
  5. Hit the “Import Products” button to begin importing your products.


March 17, 2017 3 replies
Plugin no longer working as of this week. Importation results in error message: “No product count paramater available from Etsy response. Are there any products available?” The answer is Yes, there are. Ordinarily, I wouldn’t slam a product that’s been working so well and suddenly stops, BUT, there is absolutely NO SUPPORT for this plugin ANYWHERE. No one to email or message, no support site, nothing. That is an epic fail. Yeah, I know it’s free. So is Woocommerce and google.
September 3, 2016 1 reply
downloaded and activated – got message – this page doesn’t have header. then nothing appears in settings. when manually calling settings page – shows message – no sufficient permissions. so basically cant even make it to run 🙁
Read all 12 reviews

Contributors & Developers

“Etsy Importer” is open source software. The following people have contributed to this plugin.


Translate “Etsy Importer” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • De-branding and Contributor update release only. Functionality unchanged.


  • Fix: Move CMB2 metaboxes registration to cmb2_init for compatibility with plugins using backcompat methods.


  • Fix: hopeful solution for occasional “Invalid header” issue.
  • Fix: PHP Magic Constant change for PHP 5.2 compatibility.
  • Fix: Amend error message to be more informative to user.
  • Fix: Amend settings save button text to indicate saving will process product imports.
  • Fix: Remove usage of PHP extract function in shortcodes.
  • Fix: Match metabox field definitions to current CMB2 usage.
  • Fix: Update settings page URL in readme.txt
  • Enhancement: Improvements to PHPDocs for developers.
  • Enhancement: Highlight store ID to use in screenshot.
  • Updated internationalization files.


  • With this update, you will need to save your settings to reimport your products and add the product ID as post meta.
  • Remove functionality left in place to transition from old settings page to CMB2-powered settings page
  • Import the product ID as post meta
  • Check for the existence of an imported product by comparing the product ID


  • Fix an issue with CMB2 init.php include
  • Apply post type filter to CMB2 field registration


  • If a post already exists in your WP site and its product state is no longer “Active” in your Etsy shop, set that post’s status to draft
  • Add more documentation for all of the filters present in the plugin
  • Update settings page and post meta fields to use CMB2
  • Settings menu item moved inside the CPT menu


  • Add ability to grab more than 25 products by paging through your store in sets of 25
  • Add filters to hook into shortcodes, cron schedule, and post args when importing products
  • General cleanup of code with the help of @jtsternberg. Thanks!


  • Fix line grabbing the title of a product when using a shortcode


  • Add cron job to automatically pull in products once daily
  • Add a conditional to fix the product_content shortcode from breaking when using a non-existent post ID
  • Fix product_content typo in readme.txt


  • Launch