[downloads]<\/strong><\/p>\n\n\n\n
This will output the downloads in a three column grid with thumbnails (if present), a 30 word excerpt, and a purchase button that says “Add to Cart”.<\/p>\n\n\n\n
If you wish to modify this output, here is a list of the parameters:<\/p>\n\n\n\n
- category<\/li>
- exclude_category<\/li>
- tags<\/li>
- exclude_tags<\/li>
- relation<\/li>
- number<\/li>
- price<\/li>
- excerpt<\/li>
- full_content<\/li>
- buy_button<\/li>
- columns<\/li>
- thumbnails<\/li>
- orderby<\/li>
- order<\/li>
- ids<\/li>
- pagination=true\/false<\/li><\/ul>\n\n\n\n
Both the <\/em>category<\/em>\u00a0and\u00a0tags<\/em>\u00a0parameters accept a comma separated list of IDs. For example:<\/p>\n\n\n\n
[downloads category=\"7,15\" tags=\"16,17\"]\n<\/pre>\n\n\n\n
You can find a category’s ID by going to Dashboard \u2192 Downloads \u2192<\/em> Categories<\/em>, then click “edit” below the category in question. On the page that loads, look at the URL in the address bar and find “tag_ID=”. The number after it is the category ID.<\/p>\n\n\n\n
![](\"https:\/\/easydigitaldownloads.com\/wp-content\/uploads\/2022\/07\/6184cc8f8b544.jpg\")
Use the same process to find a tag ID by going to Dashboard \u2192 Downloads \u2192<\/em> Tags.<\/em><\/p>\n\n\n\nThe exclude_category<\/em> and exclude_tags<\/em> parameters are used to prevent downloads with specific categories or tags from being displayed. Use a comma separated list of IDs for each.<\/p>\n\n\n\n
The order<\/em>\u00a0parameter accepts either\u00a0“DESC”<\/em>\u00a0or\u00a0“ASC”<\/em>.<\/p>\n\n\n\n
The\u00a0 orderby<\/em>\u00a0parameter accepts the following options:<\/p>\n\n\n\n
- price<\/li>
- id<\/li>
- random<\/li>
- post_date (default)<\/em><\/li>
- title<\/li><\/ul>\n\n\n\n
If orderby<\/em> is set to random<\/em>, pagination will be disabled to prevent subsequent pages from showing already-displayed products.<\/p>\n\n\n\n
The number<\/em>\u00a0and\u00a0columns<\/em>\u00a0parameters accept a numerical value. Specify the maximum number of downloads you want to outputted by the shortcode, as well as the number of columns. For example:<\/p>\n\n\n\n
[downloads number=\"15\" columns=\"3\"]\n<\/pre>\n\n\n\n
The <\/em>relation<\/em>\u00a0option is for specifying whether the downloads displayed have to be in ALL the categories\/tags provided, or just in at least one. Use “AND” for showing downloads that are filed in every category\/tag (very specific), and use “OR” for showing downloads filed in any of the given categories\/tags. Leave both of these blank to show all downloads.<\/p>\n\n\n\n
Price, excerpt, full_content<\/em>,\u00a0and\u00a0buy_button<\/em>\u00a0accept “yes” or “no”.<\/p>\n\n\n\n
The thumbnails<\/em>\u00a0parameter requires “true” or “false”.<\/p>\n\n\n\n
The ids<\/em>\u00a0parameter accepts specific download IDs. You can specify multiple download IDs using comma separated values. For example:<\/p>\n\n\n\n
[downloads ids=\"3,4,17\"]\n<\/pre>\n\n\n\n
Example:<\/strong><\/p>\n\n\n\n
[downloads category=\"14,15\" number=\"10\" columns=\"2\"]\n<\/pre>\n\n\n\n
Customizing the output programmatically in your child theme:<\/h4>\n\n\n\n
It is possible to customize the content that is output by the [downloads] shortcode by moving the template files into your child theme’s folder. Specifically, you’ll likely want to move the template file called “shortcode-download.php”, or one of its child files into your child theme’s folder. To do this, follow the guide in this doc<\/a>. Note that doing this requires advanced WordPress theme coding knowledge. If you require assistance with this, we have a consultants page<\/a> with professionals available for hire for custom code-related jobs like this.<\/p>\n","protected":false},"excerpt":{"rendered":"
You can easily output a list or grid of downloadable products using the [downloads] shortcode. This shortcode accepts a variety of parameters that allow you to specify what downloads are displayed, and how they are displayed. To show downloads with the default configuration, use this:[downloads] This will output the downloads in a three column grid […]<\/p>\n","protected":false},"template":"","edd_doc_category":[],"class_list":["post-1764724","edd_doc","type-edd_doc","status-publish","hentry"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/easydigitaldownloads.com\/wp-json\/wp\/v2\/docs\/1764724","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/easydigitaldownloads.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/easydigitaldownloads.com\/wp-json\/wp\/v2\/types\/edd_doc"}],"version-history":[{"count":0,"href":"https:\/\/easydigitaldownloads.com\/wp-json\/wp\/v2\/docs\/1764724\/revisions"}],"wp:attachment":[{"href":"https:\/\/easydigitaldownloads.com\/wp-json\/wp\/v2\/media?parent=1764724"}],"wp:term":[{"taxonomy":"edd_doc_category","embeddable":true,"href":"https:\/\/easydigitaldownloads.com\/wp-json\/wp\/v2\/edd_doc_category?post=1764724"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- title<\/li><\/ul>\n\n\n\n