{"id":1228,"date":"2013-11-12T21:02:32","date_gmt":"2013-11-12T21:02:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wp-media-library-categories\/"},"modified":"2025-05-18T07:49:20","modified_gmt":"2025-05-18T07:49:20","slug":"wp-media-library-categories","status":"publish","type":"plugin","link":"https:\/\/os.wordpress.org\/plugins\/wp-media-library-categories\/","author":13363142,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.0.2","stable_tag":"2.0.2","tested":"6.8.5","requires":"4.0","requires_php":"","requires_plugins":null,"header_name":"Media Library Categories","header_author":"Jeffrey-WP","header_description":"","assets_banners_color":"0174a3","last_updated":"2025-05-18 07:49:20","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_s-xclick&hosted_button_id=SSNQMST6R28Q2","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/wp-media-library-categories\/","header_author_uri":"https:\/\/1.envato.market\/c\/1206953\/275988\/4415?subId1=profile&subId2=plugin&subId3=wpmlc&u=https%3A%2F%2Fcodecanyon.net%2Fuser%2Fjeffrey-wp%2F","rating":4.2,"author_block_rating":0,"active_installs":20000,"downloads":561203,"num_ratings":52,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.8":{"tag":"1.8","author":"jeffrey-wp","date":"2019-09-18 20:49:18"},"1.9":{"tag":"1.9","author":"jeffrey-wp","date":"2019-11-18 21:36:08"},"1.9.5":{"tag":"1.9.5","author":"jeffrey-wp","date":"2019-11-27 22:15:17"},"1.9.6":{"tag":"1.9.6","author":"jeffrey-wp","date":"2019-11-28 21:06:36"},"1.9.7":{"tag":"1.9.7","author":"jeffrey-wp","date":"2020-03-08 13:24:41"},"1.9.8":{"tag":"1.9.8","author":"jeffrey-wp","date":"2020-08-07 18:53:06"},"1.9.9":{"tag":"1.9.9","author":"jeffrey-wp","date":"2022-10-30 20:30:23"},"2.0.0":{"tag":"2.0.0","author":"jeffrey-wp","date":"2023-03-23 14:29:43"},"2.0.1":{"tag":"2.0.1","author":"jeffrey-wp","date":"2024-11-10 09:05:55"},"2.0.2":{"tag":"2.0.2","author":"jeffrey-wp","date":"2025-05-18 07:49:20"}},"upgrade_notice":[],"ratings":{"1":9,"2":0,"3":1,"4":2,"5":40},"assets_icons":{"icon-128x128.gif":{"filename":"icon-128x128.gif","revision":2658310,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.gif":{"filename":"icon-256x256.gif","revision":2658310,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":963249,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":963249,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.8","1.9","1.9.5","1.9.6","1.9.7","1.9.8","1.9.9","2.0.0","2.0.1","2.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":1073390,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":845599,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":851549,"resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"Filter by category in the media library. Use bulk actions to add and remove categories of multiple images at once.","2":"Manage categories in the media library","3":"Filter by category when inserting media <a href=\"https:\/\/1.envato.market\/c\/1206953\/275988\/4415?subId1=wpmlcp&amp;subId2=readme&amp;u=https%3A%2F%2Fcodecanyon.net%2Fitem%2Fmedia-library-categories-premium%2F6691290\">(premium version)<\/a>"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[610,89,1980,84,27275],"plugin_category":[50,57],"plugin_contributors":[78925],"plugin_business_model":[],"class_list":["post-1228","plugin","type-plugin","status-publish","hentry","plugin_tags-categories","plugin_tags-category","plugin_tags-library","plugin_tags-media","plugin_tags-medialibrary","plugin_category-media","plugin_category-taxonomy","plugin_contributors-jeffrey-wp","plugin_committers-jeffrey-wp"],"banners":{"banner":"https:\/\/ps.w.org\/wp-media-library-categories\/assets\/banner-772x250.png?rev=963249","banner_2x":"https:\/\/ps.w.org\/wp-media-library-categories\/assets\/banner-1544x500.png?rev=963249","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/wp-media-library-categories\/assets\/icon-128x128.gif?rev=2658310","icon_2x":"https:\/\/ps.w.org\/wp-media-library-categories\/assets\/icon-256x256.gif?rev=2658310","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/wp-media-library-categories\/assets\/screenshot-1.png?rev=1073390","caption":"Filter by category in the media library. Use bulk actions to add and remove categories of multiple images at once."},{"src":"https:\/\/ps.w.org\/wp-media-library-categories\/assets\/screenshot-2.png?rev=845599","caption":"Manage categories in the media library"},{"src":"https:\/\/ps.w.org\/wp-media-library-categories\/assets\/screenshot-3.png?rev=851549","caption":"Filter by category when inserting media <a href=\"https:\/\/1.envato.market\/c\/1206953\/275988\/4415?subId1=wpmlcp&amp;subId2=readme&amp;u=https%3A%2F%2Fcodecanyon.net%2Fitem%2Fmedia-library-categories-premium%2F6691290\">(premium version)<\/a>"}],"raw_content":"<!--section=description-->\n<p>Adds the ability to use categories in the WordPress Media Library. When activated a dropdown of categories will show up in the media library.\nYou can change \/ add \/ remove the category of multiple items at once with bulk actions.\nThere is even an option to filter on categories when using the gallery shortcode.<\/p>\n\n<h4>Features WordPress Media Library Categories<\/h4>\n\n<ul>\n<li>add \/ edit \/ remove categories from media items<\/li>\n<li>change the category of multiple items at once with bulk actions<\/li>\n<li>category options &amp; management in the Media Library<\/li>\n<li>filter on categories in the media library<\/li>\n<li>filter on categories in the gallery shortcode<\/li>\n<li>taxonomy filter<\/li>\n<li>support for WordPress 4.0 \u2013 6.8<\/li>\n<\/ul>\n\n<blockquote>\n  <p><strong>Try Premium version - 100% money back guarantee<\/strong>\n  WordPress Media Library Categories Premium adds the option to filter on categories when inserting media into a post or page.\n  <a href=\"https:\/\/1.envato.market\/c\/1206953\/275988\/4415?subId1=wpmlcp&amp;subId2=readme&amp;u=https%3A%2F%2Fcodecanyon.net%2Fitem%2Fmedia-library-categories-premium%2F6691290\">Try now - 100% money back guarantee<\/a><\/p>\n<\/blockquote>\n\n<!--section=installation-->\n<p>For an automatic installation through WordPress:<\/p>\n\n<ol>\n<li>Go to the 'Add New' plugins screen in your WordPress admin area<\/li>\n<li>Search for 'Media Library Categories'<\/li>\n<li>Click 'Install Now' and activate the plugin<\/li>\n<li>A dropdown of categories will show up in the media library<\/li>\n<\/ol>\n\n<p>For a manual installation via FTP:<\/p>\n\n<ol>\n<li>Upload the 'Media Library Categories' directory to the '\/wp-content\/plugins\/' directory<\/li>\n<li>Activate the plugin through the 'Plugins' screen in your WordPress admin area<\/li>\n<li>A dropdown of categories will show up in the media library<\/li>\n<\/ol>\n\n<p>To upload the plugin through WordPress, instead of FTP:<\/p>\n\n<ol>\n<li>Upload the downloaded zip file on the 'Add New' plugins screen (see the 'Upload' tab) in your WordPress admin area and activate.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in your WordPress admin area<\/li>\n<li>A dropdown of categories will show up in the media library<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20to%20use%20separate%20categories%20for%20the%20wordpress%20media%20library%20%28and%20don%27t%20use%20the%20same%20categories%20as%20in%20posts%20%26%20pages%29%3F'><h3>How to use separate categories for the WordPress Media Library (and don't use the same categories as in posts &amp; pages)?<\/h3><\/dt>\n<dd><p>By default the WordPress Media Library uses the same categories as WordPress does (such as in posts &amp; pages). If you want to use separate categories you can use a custom taxonomy, this can be set under Settings \u2192 Media (or click on the settings quicklink on the WordPress plugins overview page).<\/p><\/dd>\n<dt id='how%20to%20use%20category%20in%20the%20%5Bgallery%5D%20shortcode%3F'><h3>How to use category in the [gallery] shortcode?<\/h3><\/dt>\n<dd><p>To only show images from one category in the gallery you have to add the '<code>category<\/code>' attribute to the <code>[gallery]<\/code> shortcode.\nThe value passed to the '<code>category<\/code>' attribute can be either the <code>category slug<\/code> or the <code>term_id<\/code>, for example with the category slug:<\/p>\n\n<pre><code>[gallery category=\"my-category-slug\"]\n<\/code><\/pre>\n\n<p>Or with term_id:<\/p>\n\n<pre><code>[gallery category=\"14\"]\n<\/code><\/pre>\n\n<p>If you use an incorrect slug by default WordPress shows the images that are attached to the page \/ post that is displayed. If you use an incorrect term_id no images are shown.<\/p>\n\n<p>Aside from this behavior, the <code>[gallery]<\/code> shortcode works as it does by default with the built-in shortcode from WordPress (<a href=\"https:\/\/codex.wordpress.org\/Gallery_Shortcode\">see the WordPress gallery shortcode codex page<\/a>). If you only want to show attachments uploaded to the page and filtered by category than use the '<code>id<\/code>' in combination with the '<code>category<\/code>' attribute. For example (the id of the post is 123):<\/p>\n\n<pre><code>[gallery category=\"my-category-slug\" id=\"123\"]\n<\/code><\/pre>\n\n<p>Or leave id empty for current page \/ post:<\/p>\n\n<pre><code>[gallery category=\"my-category-slug\" id=\"\"]\n<\/code><\/pre>\n\n<p>In this example the slug is used, but you could also use the term_id.<\/p><\/dd>\n<dt id='how%20can%20i%20filter%20on%20categories%20when%20inserting%20media%20into%20a%20post%20or%20page%3F'><h3>How can I filter on categories when inserting media into a post or page?<\/h3><\/dt>\n<dd><p>This feature is only available in the <a href=\"https:\/\/1.envato.market\/c\/1206953\/275988\/4415?subId1=wpmlcp&amp;subId2=readme&amp;u=https%3A%2F%2Fcodecanyon.net%2Fitem%2Fmedia-library-categories-premium%2F6691290\">premium version<\/a><\/p><\/dd>\n<dt id='i%20want%20to%20thank%20you%2C%20where%20can%20i%20make%20a%20donation%3F'><h3>I want to thank you, where can I make a donation?<\/h3><\/dt>\n<dd><p>Maintaining a plugin and keeping it up to date is hard work. Please support me by making a donation. Thank you.\n<a href=\"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_s-xclick&amp;hosted_button_id=SSNQMST6R28Q2\">Please donate here<\/a><\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.0.2<\/h4>\n\n<ul>\n<li>Update Select2 dependency<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>Fix XXS vulnerability<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Add escape function for input field custom taxonomy slug<\/li>\n<\/ul>\n\n<h4>1.9.9<\/h4>\n\n<ul>\n<li>Fix 'jQuery.fn.load() is deprecated' warning<\/li>\n<\/ul>\n\n<h4>1.9.8<\/h4>\n\n<ul>\n<li>Remember selected category in dropdown when filtered<\/li>\n<\/ul>\n\n<h4>1.9.7<\/h4>\n\n<ul>\n<li>Add autocomplete search to the category dropdown in Media Library list view (which can be turned on under Settings \u2192 Media)<\/li>\n<li>Add usability fix to highlight media library settings section when directly linked<\/li>\n<\/ul>\n\n<h4>1.9.6<\/h4>\n\n<ul>\n<li>Fix taxonomy checkbox on media modal (when using custom taxonomy)<\/li>\n<\/ul>\n\n<h4>1.9.5<\/h4>\n\n<ul>\n<li>Add autocomplete search to the category dropdown in Media Library grid view (which can be turned on under Settings \u2192 Media)<\/li>\n<li>Fix some translation strings<\/li>\n<\/ul>\n\n<h4>1.9<\/h4>\n\n<ul>\n<li>Add interface (located under Settings \u2192 Media) to separate the media categories from the default WordPress categories<\/li>\n<\/ul>\n\n<h4>1.8<\/h4>\n\n<ul>\n<li>Indent child categories in checklist media popup<\/li>\n<\/ul>\n\n<h4>1.7<\/h4>\n\n<ul>\n<li>Support WordPress 5.0<\/li>\n<li>Support multiple slugs and id's in gallery shortcode<\/li>\n<li>Support WordPress Coding Standards 1.1.0<\/li>\n<li>Add support for <a href=\"https:\/\/wordpress.org\/plugins\/dark-mode\/\">Dark Mode<\/a> in WordPress<\/li>\n<\/ul>\n\n<p><a href=\"https:\/\/jeffrey-wp.com\/media-library-categories-changelog\/?utm_source=plugin&amp;utm_medium=changelog&amp;utm_campaign=wpmlc\">See complete changelog for all versions<\/a>.<\/p>","raw_excerpt":"Adds the ability to use categories in the media library.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/1228","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=1228"}],"author":[{"embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jeffrey-wp"}],"wp:attachment":[{"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=1228"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=1228"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=1228"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=1228"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=1228"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/os.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=1228"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}