WP eStore Shortcodes and Functions Reference

Categories: Additional Resources, Featured

This page has all the available Shortcodes and PHP functions that you can use to create various buy and download buttons, shopping carts, product details etc. in various ways.

WP eStore Standard Shortcodes List

The following PDF file has a list of all the standard shortcodes available in the WP eStore core plugin.

WP eStore Shortcodes & PHP Functions List

See the following section (Extra Shortcodes) for additional eStore shortcodes.

Extra Shortcodes and Function References

Some people just like to go nuts with WordPress shortcodes and there is nothing wrong with that . So if you are not satisfied with the default set of shortcodes that comes with the WP eStore plugin then download and install the “Extra WP eStore Shortcodes” plugin and you will have access to many more cool shortcodes.

First, check the list of shortcodes and other functions that will be available to you when you use the extra shortcodes addon plugin from the PDF file below:

Extra WP eStore Shortcodes List

You can download this addon from the addon download area of our customer only support forum

Addon download area

Feel free to make a suggestions for shortcodes that you need and we will try to add it in.

Available Email Tags

The following tags can be used in the “Email Body” of the email that is sent out after a purchase (the tags will be replaced with the value dynamically):

{first_name} – First name of the buyer
{last_name} – Last name of the buyer
{payer_email}- Buyer email address
{product_details} – Lists the item name (with variation), quantity, currency and price of every purchased item.
{product_name} – Name of the purchased products (comma separated)
{product_link} – List of purchased products and corresponding encrypted download links for the products.
{product_link_digital_items_only} – List of purchased digital items with encrypted download links (The item is only listed if the product has a downloadable file)
{product_price} – Price of the purchased products (comma separated)
{product_id} – Product IDs of the purchased products (comma separated)
{download_life} – Duration the download links are valid for.
{shipping_info} – Buyer’s shipping address
{shipping_option_selected} - The selected shipping variation for the transaction
{product_specific_instructions} – Add the product specific instructions (e.g password for a PDF file) specified in the product to the email body.
{purchase_date} – The date of the purchase.
{transaction_id} – The unique transaction ID of the purchase.
{purchase_amt} – The amount paid for the current transaction.
{total_tax} – Total tax amount for this transaction.
{total_shipping} – Total shipping amount for this transaction.
{total_minus_total_tax} – The total amount minus the total tax.
{coupon_code} – The coupon code that was used in the transaction.
{counter} - A numeric counter. Each time you make a sale this counter goes up by 1.

Ivy Says:
March 19th, 2013 at 12:46 am

@Amanda, Either one of these shortcode should be what you are looking for.

If you want the cart to show all the time.

[wp_eStore_cart]
Display the shopping cart on a post or page

If you want the cart to only show when it is not empty.

[wp_eStore_cart_when_not_empty]
Display the shopping cart on a post or page but the
cart is visible only when there are items in the cart

Amanda Says:
March 18th, 2013 at 5:30 pm

What is the exact shortcode for to mimic the “WP cart for digital products” widget? I want the same exact code to show on all sidebars, but the widget provided with eStore only allows for one widget use. I have multiple sidebars. The shortcodes you provide are not exactly the same and only show the basket occasionally.

I tried [wp_eStore_display_compact_cart show_empty=1
show_sub_total=1 show_title=1 show_cart_image=1]

Ivy Says:
March 26th, 2012 at 12:16 am

@Peter, All you need to do is copy the shortcode you want from the following PDF file and paste it on the page where you want it to be displayed.

http://www.tipsandtricks-hq.com/ecommerce/wp-estore-shortcodes-and-functions-reference-460

Peter Says:
March 25th, 2012 at 9:37 am

Hi,
Thanks your answer, about extra shortcodes. I downloaded it, and that is in the plugins, and I activated it. But how can I use it in the page?

Thanks,

Peter

admin Says:
February 20th, 2012 at 12:35 am

Yeah, there is an option for this already. The above shortcode that you explained will work.

Alan Says:
February 19th, 2012 at 12:46 am

How about a category listing with a no price option? Is that possible already? Something like this: [wp_eStore_category_products_fancy id=1 style=9 order=1 type=4 showprice=0] Thanks!

Ivy Says:
September 2nd, 2011 at 1:52 am

@Brent, in the extra shortcodes plugin there are search shortcodes. You can find them in the list above “Download a PDF version of the available Extra WP eStore Shortcodes”.

Brent Haskins Says:
September 1st, 2011 at 7:15 pm

Is there a short code for store navigation?

Ivy Says:
August 23rd, 2011 at 1:54 am

@ACD, We have many pre-made display options which can be found here:

http://www.tipsandtricks-hq.com/ecommerce/stylish-product-display-options-for-wp-estore-829

Displays such as Fancy 3,5 and 6 can be used to create a grid view.

Also there is an option to use NextGen Gallery:

http://www.tipsandtricks-hq.com/ecommerce/wordpress-estore-and-nextgen-gallery-integration-to-create-digital-photo-store-method-1-1232

ACD Says:
August 22nd, 2011 at 2:58 pm

Hi, Have you added a way to display products in a simple grid view? It seems to me that this would be something everyone would want.
Please let me know.

Ivy Says:
May 6th, 2011 at 4:22 am

Hi Kelly, You can see all the fancy displays here:

Kelly Vaughn Says:
May 6th, 2011 at 1:45 am

Do you have a visual example of what the different shortcodes look like when applied to a product? For example. I want to know the difference between a fancy display and a non-fancy display? And how style 1 is different than style 2, style 3, etc. I can test out each option and refresh the page, but it would be really handy to have a visual reference. Do you have anything like that?

Ivy Says:
April 24th, 2011 at 7:14 am

Hi Wendy, What version of the eStore are you using?

Wendy Says:
April 24th, 2011 at 6:52 am

Hi there, the [wp_eStore_download_link_sender] shortcode doesn’t work for me. I have the plugin installed but the form does not show up. Is there anything I can do about that?

admin Says:
December 3rd, 2010 at 5:10 am

@David, you can use any type of button with any type of style using the following shortcode:

[wp_eStore_fancy_display id=1 type=1 style=1]

Please check the extra shortcodes plugin for this.

David Hamilton Says:
December 2nd, 2010 at 7:38 pm

Sorry. I truncated my own commentl by mistake. Let me try again.

I would love to see the fancy2 BUY NOW button code. The code for the BUY NOW fancy1 is [wp_eStore_buy_now_fancy id=1] but I would love to see it with the fancy2 option as well.

I am enjoying setting up the cart for the first time. Thanks.

David Hamilton Says:
December 2nd, 2010 at 7:35 pm

I would love to see the fancy2 BUY NOW button code. This is the code for the BUY NOW

Ivy Says:
November 10th, 2010 at 4:29 am

Hi Vinnie, Did you set a “Product Page URL” in the “Add/Edit Products Menu” under “additional product details”?

Vinnie Says:
November 9th, 2010 at 8:31 pm

Hi,
I have added the additional shortcodes and have requested that a list of products from a category be displayed on a page. (http://vitality-naturally.com/?page_id=645) using the command [wp_eStore_category_products_fancy id=1 style=3
order=1]

Problem is that when you click on the Details button it doesnt bring you anywhere.
Same thing happens when I use ([wp_eStore_list_categories]) to display all categories.

Any ideas?

Vinnie

scotty777 Says:
November 7th, 2010 at 2:34 am

Regarding the topic of free downloads I am curious if the following work (see admin response to Diane Jan 14th2010)

Set up a page with direct download links for the freebies as you indicated BUT use WP-Members to force registration in order to access the page? You could also add Aweber Integration plugin and also get the registration over to Aweber autoresponder.

One other option which might be something to consider is allow product detail to allow for a Manual Checkout Only ? That would at least get you a full set of information on the potential customer and check of autoresponder in the manual gateway.

The reason is that it might be nice to have categories set up as FREEWARE and thus use the wonderful formating options of eStore… Something to consider I suppose. Anyway…. Thanks for a GREAT plugin !!!

Sandra Says:
September 24th, 2010 at 11:10 am

The estore plugin allows you to show a field that’s for an affiliate ID. Is the affiliate ID the same as their user ID?

Thanks,
Sandra

Tony Norella Says:
September 20th, 2010 at 3:54 am

yes i finally figured that one out.. it would be very nice if there were a little comment above that field saying html allowed or at the very least somewhere in the documentation..

Ivy Says:
September 20th, 2010 at 2:35 am

Hi, Did you use </br> for the line breaks? You need to use HTML for this.

Let me know how it goes.

Tony Norella Says:
September 19th, 2010 at 4:52 am

i can’t seem to get the fancy style description to format correctly.. i inputed the description on the product and formatedd by hitting carriage retun when needed and it looks good there – but when you go to the site, there are no line breaks and everything runs together.. did i miss something?

Ivy Says:
September 7th, 2010 at 4:24 am

Hi Kim, I think Fancy 3 would be the closets to what you are looking to do. You can view all the fancy displays here:

Kim Says:
September 7th, 2010 at 12:07 am

Ivy, Can I do a grid style of categories instead of the “Fancy” display?

Thanks!

Fran Says:
September 2nd, 2010 at 5:23 pm

Thanks!!!!

admin Says:
September 2nd, 2010 at 8:12 am

@Fran, I will add one in.

fran Says:
September 1st, 2010 at 10:59 pm

Need a short code or plug in that creates a DROPDOWN of categories…I’ve got 20 cats and it takes up too much sidebar space. Thanks.

Geli Says:
August 17th, 2010 at 8:40 am

Thank you Ivy for your reply. Yes, I figured this out.. Was just hoping customers/clients would have been able to do that as they are adding the items to the cart.

Still, it’s a great plugin. Thank you.

Geli.

Ivy Says:
August 17th, 2010 at 3:29 am

Hi Geli, They should just be able to change the quantity they way to purchase in the cart after it has been added.

Geli Says:
August 16th, 2010 at 4:06 pm

Hi there!

I am trying to figure out how to allow a customer have multiples of the same.

e.g. I offer coaching services (amongst other things). So, I like to show a base unit session for a specific price, but if the customer wants to buy e.g. 5 sessions, I’d like them to just add the amount of sessions they would require – or would they have to buy the base session 5 times by clicking on it 5 times …

Thank you,

Ivy Says:
June 17th, 2010 at 1:05 am

Hi Michael, This email tag was recently added, I believe you just need an update to fix this issue. You can find out more about how updates work here: http://www.tipsandtricks-hq.com/forum/topic/how-and-when-do-you-get-an-update

Michael Oeser Says:
June 16th, 2010 at 7:24 am

Hi Ivy,

the email shortcode {product_details} doesn´t seem to work. It doesn´t print anything else but {product_details} and not the details of the product. Any idea why this can be?

Cheers
Michael

Leeann Says:
June 14th, 2010 at 7:15 am

Awesome. Thanks Ivy!

Ivy Says:
June 14th, 2010 at 2:31 am

Hi Leeann, I believe you need to specify a button image for this product. You can do this under the “Add/Edit” products menu for that product. The “Button Image URL” field is under “Additional Product Details “. Once you add a button image this should fix the problem you are having.

Leeann Says:
June 13th, 2010 at 12:10 am

Hi,
I love this plug-in! Well done.

I’m trying to provide a simple free digital download on my site, but I get no download button image. What simple thing have I missed?

The tag i’m using is [wp_eStore_free_download:product_id:2:end]

Many thank,

admin Says:
June 7th, 2010 at 5:57 am

If you post your code on the forum then I will be able to take a look at it and tell you what it needs:

http://www.tipsandtricks-hq.com/forum/

Aaron Says:
June 5th, 2010 at 11:10 pm

Hi. im trying to put a background behind a squeeze page in my sidebar, I’m not doing something right though, what code should i be using?

Ivy Says:
May 26th, 2010 at 2:23 am

Hi Kelly, The plugin uses the email address from PayPal. You can changes these emails if you need to in the “Manage Customers” menu. If you would like a comma separated list of the email you can also do this under the “Manage Customers” menu option number 3.

You can have a text field where the customer can enter in information that will be sent to you but there is a limit of characters and the email address maybe cut off.

Maybe a note on the Thank you page that says your product will be delivered to your PayPal email address or if you need to change this address please contact us.

Cheers,
Ivy

kelly willette Says:
May 26th, 2010 at 1:38 am

hey there…i’m setting up my estore now (LOVE your product…it is so great), and i have a question regarding customer email addresses…i like to keep track of these. if someone purchases my edownload products (and they pay via paypal), how do i get a list of their emails? what if they’re real email is different than their paypal one? does this program ask (or CAN it ask) for their email in the one step check out process?

Ivy Says:
May 6th, 2010 at 12:36 am

Hi Tanya, I am glad the checkout page is working fine now.

1.) Yes you need IPN turned on. You can make the URL whatever you would like as the eStore will override this and tell PayPal where to send the IPN. This should fix your link problem. If not please send me a link to the test product and I will take a look at it.

2.) In the main setting of the plugin you can change the from email address. You will need to make sure the “Use WordPress Mailing System” is unchecked and that “From Email Address*” is correct. This should fix this problem.

If this is not what you are looking for please let me know.

Tanya Kersey Says:
May 5th, 2010 at 2:49 pm

Thanks Ivy. That worked perfectly and my Checkout page is fine now.

I have 2 more problems though.

(1) I created a .01 test product and when it was completed it didn’t automatically send me to the page I specified in the settings. When I clicked return to merchant I got a Post Form error message. Should I have IPN turned on or off in PayPal and if on, what’s the IPN URL? Or is this caused by a completely different problem.

(2) The email sent to the customer came from WordPress, not my name.

Thanks for your help.

Tanya

Ivy Says:
May 5th, 2010 at 12:37 am

Hi Tanya, You can find a list of all the eStore shortcodes here: http://www.tipsandtricks-hq.com/ecommerce/wp-estore-shortcodes-and-functions-reference-460

I believe one of the following shortcodes is what you are looking for:

Let me know if you need anything else.

Tanya Says:
May 4th, 2010 at 8:58 pm

Help! I’ve got everything working good so far but for the life of me I don’t understand what to put on the checkout page to make it work. Is it a shortcode?

Thanks.

Tommy Says:
April 20th, 2010 at 2:27 pm

Hi,
I’m already using this plugin with two of my websites and a third is coming soon.
Since I’m using custom themes and post templates it would be very helpful if you could add tags for single elements such as [eStore_element_name:id:1:end] for product name, description, thumb, image etc.
This way I could place them as I like in the post.

Ellen Says:
March 29th, 2010 at 8:07 am

HI Ivy,

I figured it out and it works beautifully now!
Wordpress was automatically placing paragraph tags before and after the shortcode – once i removed those it all works ) <>

Blessings,
Ellen

Ivy Says:
March 29th, 2010 at 5:58 am

Hi Ellen, The following article will explain more on how to use categories: http://www.tipsandtricks-hq.com/ecommerce/wordpress-estore-product-categorization-431

Let me know how it goes and if this helps you.

Ellen Says:
March 29th, 2010 at 2:04 am

Hi,

I can get the all products to show but when I try to use the shortcode for the categories to show nothing shows.

Any idea what I am doing wrong?
The shortcode I was using is: [wp_eStore_category_products:category_id:2:end]

admin Says:
January 16th, 2010 at 1:51 am

Hi Michael, There is no shortcode for a bestselling list but it’s coming.

Michael Says:
January 15th, 2010 at 5:33 pm

Is there no shortcode or other way to display a list of bestselling products? Seems like something that would be a commonly requested feature, and easy to implement since the plugin already keeps a count of sales for each product, but I’ve searched the site and can’t find any reference to it.

Dianne Says:
January 14th, 2010 at 6:06 pm

Well exactly that is an option, as I mentioned. I am sure you can see where entering the data to the shop format would be somewhat easier than having to write html for each free item. It makes it more of a streamlined process of product entry rather than hard coding each individual freebie into the page. Easier to track, easier to set up, easier to move or remove, etc. There are different mind sets about freebies and I need to decide, I suppose, which one applies to me and proceed accordingly. Thanks for your time! I am loving the cart!

admin Says:
January 14th, 2010 at 8:02 am

Hi Dianne, nope, the download button’s can’t be displayed in the fancy option. To be honest with you, the whole reason for having encrypted time limited download links is to protect the security of your digital asset. If you are giving you away for free (I mean absolutely free) then why not just have a direct download link like I have for all my free plugins (e.g. http://www.tipsandtricks-hq.com/?p=768 )

Dianne Says:
January 14th, 2010 at 1:39 am

(ETA worst case scenario is that I don’t run the freebies through the cart at all, which is also an option. )

Dianne Says:
January 14th, 2010 at 1:38 am

Working on this and having loads of fun! I love word press and now this plug in. Hey, is there any way to have a fancy box to show all the products in a category, but have it display a download now button instead of an add to cart? I plan to have a small freebie section that I would like to avoid administering in the cart (for obvious reasons). You can see what it looks like right now – http://www.diannerigdon.com/design/shop/freebies – very confusing to the customer, I am sure. I need to either have them use manual check out and somehow have it automatically give them the links after manual check out (not my favorite option) OR….have a fancy box with the download link inside. Thanks in advance for your input!

Ivy Says:
January 8th, 2010 at 11:18 pm

Pierpaolo, You can add 200 product with the same name using a script, but you would have to be able to write the script.=) We do not have a script to do this. We do plan to add this in the future. You can add it to the wishlist if you would like also.
Ivy

Pierpaolo Says:
January 8th, 2010 at 9:34 pm

Hello!
Can I insert 200 products that have same name, without inserting them one-by-one? Can I use a script or a SQL Query?
Thanks!

admin Says:
December 6th, 2009 at 9:00 pm

The version number is wrong (v2.5.8) which means the upgrade didn’t happen properly. I will send you another email.

Lynn P. Says:
December 6th, 2009 at 4:28 pm

BTW, I made another test page to see if perhaps the issue was the other plugins working on that page (e.g. the cforms or the page columnist) and again, the shortcode for the product worked and displayed properly but the shortcode for the cart did not. And I tried both putting it into the visual display using the shortcode and also using the html code you provided. Still didn’t work – the code just displays as text on the page.

Lynn P. Says:
December 6th, 2009 at 4:19 pm

I am certain I didn’t make a mistake. I used the other short code to display the product in the “fancy” style on this exact same page and it works. So it doesn’t make sense that the short code to display the cart doesn’t work on the same page. I activated the plugin — otherwise the product wouldn’t be appearing on the page and it is. I believe I upgraded properly — the dashboard says I am using v2.5.8. Is that the one you sent me? And I am indeed placing the shortcode in page body as it is appearing as text on the page and hence my problem.

I also tried using the html code you provided and putting that in the html display of the page and it just converted it to the shortcode function on the visual display but is not actually displaying the cart.

My page again is: http://margiewarrell.com/women-on-the-move-leadership-conference/register-women-on-the-move-conference/

Would it be helpful for you to look at my backend admin panel? Any other suggestion? Right now, without being able to see the shopping cart, I will not be able to use this page because when a person buys they cannot tell if it worked b/c they can’t see the cart and therefore cannot checkout.

admin Says:
December 6th, 2009 at 8:04 am

@Vik, the following URL has instructions to use “Buy Now” button.

http://www.tipsandtricks-hq.com/ecommerce/?p=15

admin Says:
December 6th, 2009 at 8:02 am

@SteHe, see below

{product_name}
{product_id}
{product_link}
{first_name}
{last_name}
{payer_email}

admin Says:
December 6th, 2009 at 8:01 am

@Lynn, it should just work.. make sure you haven’t made a mistake (eg. didn’t activate the plugin, didn’t upgrade properly, there is a typing mistake in the shortcode, make sure you are placing the shortcode inside the post/page body and not in the template file etc).

You can also use the following shortcode in HTML view to display the shopping cart:

<!–show-wp-cart-for-digital-products–>

Vik Says:
December 6th, 2009 at 7:02 am

How do you change the ‘buy now’ button… can i read how it is done someplace on your blog

SteHe Says:
December 5th, 2009 at 6:58 pm

Hello,
where can I find the shortcodes for the eMail options?

{product_name} {product_id} ….

Lynn P. Says:
December 5th, 2009 at 3:20 pm

Hi, I downloaded the newest version, moved the files to the plugins directory and de-activated and re-activated the plugin and that didn’t do the trick. That code is not working — still appearing as text in the actual page. Any other fixes I should try?

admin Says:
December 5th, 2009 at 6:57 am

@Lynn, the shortcode you are using is something I introduced recently… you may not have the latest version (I have sent you an updated version).

Lynn P. Says:
December 5th, 2009 at 6:35 am

Hi, I can’t seem to get the shopping cart to appear on this page using the short code provided: http://margiewarrell.com/women-on-the-move-leadership-conference/register-women-on-the-move-conference/

Can you advise what I am doing wrong? I used the same type of coding and the product showed but not the cart. Thanks.

Sandra Says:
November 23rd, 2009 at 11:39 am

My apologies, I didn’t realize that I was using a different WP plugin but I’m glad that I stumbled upon your site. I really like the fact that there’s support….the fact that you promptly responded to my posted questions says a lot about your customer service.

I’ll definitely check out your demos today, rather than spend more time trying to figure out how to the other plugin.

admin Says:
November 23rd, 2009 at 7:46 am

Hi Sandra, I can’t find your email address in my customer database. Are you sure you are using the WP eStore plugin and not some other shopping cart plugin? It has happned before (someone was using another shopping cart plugin was using the shortcodes specified in this page

Sandra Says:
November 23rd, 2009 at 1:01 am

Help! I’m a newbie and can’t seem to get the short codes to work. I’ve tried placing them on a page, only to get the short code to appear and not an ‘add to cart’ button. I’m not sure what I’m doing wrong.

admin Says:
November 16th, 2009 at 12:06 am

@Linda, Use the following in a post or page:

[wp_eStore_cart]

or the following from your theme’s template files:

<?php echo wp_digi_cart_always_show(); ?>

Linda Says:
November 15th, 2009 at 12:49 pm

Hello, what is the code for the shopping cart to show all the time even if it is empty, sorry, I know it was posted before, but I can’t find it anymore.
Thanks

admin Says:
October 23rd, 2009 at 9:39 pm

@Mindi, yeah, use the following to display it in a post or page:

<!–show-wp-cart-products-table–>

or the following to display it from a PHP file (eg. the template file)

<?php echo wp_estore_products_table(); ?>

I will add them to the shortcodes list

Mindi Says:
October 23rd, 2009 at 8:09 pm

Is there a code display all products but not in a fancy way? Just a plain list of all products?

admin Says:
October 22nd, 2009 at 6:20 am

Hi Mindi, not yet, you can manually do it though. I have been working on some major structural changes on this plugin to accommodate other payment gateways (eg. 2Checkout, Google Checkout, Manual Checkout) and it’s been talking all my time. Once this is done I will work on the fancy display for Buy Now button.

Mindi Says:
October 21st, 2009 at 10:11 pm

Is there a Fancy display for Buy now?

admin Says:
October 18th, 2009 at 7:20 am

Hi Zac, yes you can use the following PHP function (1 is the product id):

<?php echo print_eStore_buy_now_button(1); ?>

zac Says:
October 18th, 2009 at 4:09 am

Is it possible to use a php function rather than the short code to call the individual products buy it button ? I ask because rather than use the short code I would like to include this as a custom field where you just plug-in the id #

Bean Says:
October 9th, 2009 at 6:54 am

OK, this is why one should NOT be doing web design with a headache! Thank you for catching that. I found the stylesheet for the product description and changed it.
Thank you!

admin Says:
October 9th, 2009 at 6:07 am

@Bean, It’s showing fine but it’s not visible cause you seem to be using white font on white background? Try selecting the area with the mouse where your description is and you will see it.

Bean Says:
October 9th, 2009 at 6:03 am

I can’t get the descriptions to show on the fancy short codes.
Here is a link to demonstrate http://criminal-indictment.com/shopping-cart/
I have entered in full product descriptions but they don’t show.

admin Says:
September 20th, 2009 at 1:04 am

Hi Barbie, you have used the same product id for both of the buttons that is why it’s adding the same product!

You need to add/configure a different product for each service or product you have and then use it’s corresponding product ID to display the “Add to Cart” button for that product or service. Let me know if this helps.

Barbie Says:
September 19th, 2009 at 10:19 pm

Hi there. I’m not 100% Clear on how to add the products to the site. Do we do this through a page or post? The reason I’m asking is because I tried both ways, and have several items both Service, and Product. What I did was Add a Products Page, and a Services Page. Then to the Services page, I added the services…. Once I press the Add to Cart Button, it will only add the First product at any time, in otherwords, even if I add the 3rd service to the cart, it still only picks up on the pricing of the First Product. So if my 3rd Service is $197.00 it will Still put the $97.00 in the Cart no matter how many times I press the Add to Cart.

So How do I get the Shopping cart to recognize each service separately?

Thanks In Advance, Barbie

Here is the link to my blog so you can see what I mean.

http://www.personalbrandingforprofit.com/blog/