Skip to main content
Code Tutorial

The Main WordPress Loop

"The Main Loop" is responsible for loading the initial posts in your theme. This means the main loop controls how many posts are shown on the blog archive and in a custom post type archive. If you want to edit the number of posts in the main loop you need to use the pre_get_posts hook.

Below you tell WordPress to show 15 posts on the blog archive page and 20 for a "team" post type archive page.

Here is the code you would add to your functions.php file to edit the main WordPress loop.

<?php // functions.php
add_action( 'pre_get_posts', function( $loop ) {

    if ( is_admin() || ! $loop->is_main_query() ) {
        // do nothing if in the admin or not in the main loop

    if ( is_home() ) {
        // Show 15 posts for the blog archive
        $loop->set( 'posts_per_page', 15 );

    if ( is_post_type_archive( 'team' ) ) {
        // Show 20 posts for the custom post type 'team'
        $loop->set( 'posts_per_page', 20 );

}, 1);

Access More TypeRocket

Join our community mailing list and get notified before anyone else. Get videos and more.

By using our website you agree to our Cookie policy.