Chris Wiegman Chris Wiegman

Excluding a Category from your WordPress Homepage

Excluding a Category from your WordPress Homepage

Sometimes it isn’t always appropriate to have every category in your blog show up on your blog’s homepage. An example of this is the “Software Updates” you see in the sidebar on this site. While I write the updates as regular posts I’ve found (through trial and error) that not everyone wants to read them so I pull them from the list of posts on my homepage and use a plugin to put them in my sidebar. I do this with a bit of my own code to remove them from the homepage and then use a plugin to display what I want in the sidebar using a widget? Why not do both with my own code? Frankly, when I get time I’m going to remove the plugin entirely and do both through my own code but time hasn’t been on my side for such a change yet. In the meantime, I use my own code to remove the updates from the homepage simply because my solution is simpler and lost costly in terms of performance than any plugin I’ve seen try to do the same thing.

Fortunately WordPress makes it really easy to write this code yourself and include it within your theme’s functions.php file. Here’s what you need to do:

1.) Get your Category ID.

To do the ID go the the “Categories” menu item under posts. Click “edit” for the category you want to exclude. On the edit screen copy the Category ID from the URL (see image).

Copy the category ID from the URL
Copy the category ID from the URL

2.) Open you theme’s functions.php file.

If your theme doesn’t have one you may need to create it.

3.) Add a function to remove the category.

Now we’re going to create a function to remove the category from the blog page. This is what does the heavy lifting. Notice the -230 on my example. The minus tells WordPress to remove the category where 230 is the category ID. Replace 230 with the ID you copied from step 1.

// Exclude category from homepage.
function my_exclude_category( $query ) {

  if ( $query->is_home ) {
    $query->set( 'cat', '-230' );

  return $query;

}Code language: PHP (php)

4.) Tell WordPress to run your function

Just because we’ve added a function doesn’t mean WordPress will use it. A function by itself does nothing if not call from somewhere so we’re going to hook it into WordPress and tell it to run before WordPress gets our posts from the database. Use the following code, either before or after the function you created in functions.php to tell WordPress to run it.

add_filter( 'pre_get_posts', 'my_exclude_category' );Code language: PHP (php)

Note the pre_get_posts. This tells WordPress when to run the hook, in this case before getting the posts from the database. Next my_exclude_category tells WordPress what function to run at pre_get_posts. This is how WordPress hooks work and is used throughout WordPress themes and plugins. Every time you see an add_action line in your code the first part is where to run the action and the second is the action to run.

5.) Check your blog page.

Now all you need to do is test it. Check your blog page and make sure the posts you want aren’t showing. If it isn’t working check your spelling in the code and make sure the -[id] is showing the correct ID number for the posts you want to exclude.