The WordPress Loop is the code that turns a query’s posts into the titles, content, metadata, and links visitors see in a theme. have_posts() checks whether another result is available; the_post() advances to it and prepares the global post data for template tags. You can adjust the main query with pre_get_posts, create an additional list with WP_Query or get_posts(), and restore the original post context with wp_reset_postdata(). Avoid query_posts(): WordPress documents it as a complete override of the main query that can break pagination and discard URL-derived variables.
Antihost offers managed WordPress hosting with free migration, one-click staging and a 14-day free trial.
What the WordPress Loop does
WordPress builds a query from the front-end URL a visitor requests. A home page, category archive, search result, author archive, and single-post URL each produce a different set of query variables. The selected template file runs the primary Loop over that result.
As an Amazon Associate I earn from qualifying purchases.
Quick wins for a faster PC:
Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →The WordPress Theme Handbook describes the Loop as “the default mechanism WordPress uses for outputting posts through a theme’s template files.” In practical terms, the Loop is an iteration plus a post-context setup step. The iteration decides whether another result exists; the setup step makes template tags refer to the current result.
A minimal Loop looks like this:
<?php
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
the_title();
the_content();
endwhile;
else :
echo 'No posts found.';
endif;
?>The code has three distinct parts:
- Initial check: The first
have_posts()call determines whether the query returned at least one post. - Iteration: The
whilecondition checks for another result on every pass. - Setup and output:
the_post()advances to the next result and prepares the title, content, author, permalink, and other template data used in the body.
If the query is empty, the else branch renders a useful empty state instead of leaving a blank region. Every archive, search template, or custom query that can return zero posts should have an equivalent branch.
#1 Best Overall
- [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
- [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
- [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
- [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
- [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.
How have_posts() and the_post() work together
have_posts() checks the query cursor
have_posts() asks the current query object whether another post is available. It does not output anything and it does not set up a new current post. In the standard pattern, it is called once before the loop and again as the while condition.
the_post() advances and sets global context
the_post() moves the query to its next post and sets up the global post context. Functions such as the_title(), the_content(), the_author(), and permalink-related template tags then read the post selected by that call. Calling output tags before the_post() means there may be no correctly prepared post for them to use.
Why an extra “peek” can be surprising
When WP_Query::have_posts() reaches the end of its result set, it returns false, fires the loop_end action, and rewinds the posts. A later have_posts() check can therefore begin from the start again. Do not add an extra check inside a loop merely to “peek” at whether a post remains; it can change how a later check behaves.
The main query and the template that displays it
The main query is the query WordPress creates for the requested URL. The primary Loop consumes that query in the template selected by the theme. On an archive, for example, the query contains posts matching the archive’s taxonomy or date. On a search page, it contains results matching the search terms.
Changing the main query and adding another list are different jobs. Before writing code, decide whether you need to alter the posts that define the page or simply display extra posts alongside them.
Rank #2
- 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
- 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
- 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
- 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
- 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.
| Need | Preferred approach | When it runs | Main-query impact | Reset required |
|---|---|---|---|---|
| Change which posts an archive or search page contains | pre_get_posts |
After query variables are created, before the database query runs | Changes the targeted main query | No separate post-data reset |
| Render an additional list inside a template | new WP_Query( $args ) |
When the template executes the secondary query | Leaves the main query object intact, but changes global post context while iterating | Call wp_reset_postdata() after the loop |
| Fetch a simple additional list | get_posts( $args ) |
When the function is called | Uses a separate query and does not alter the main Loop | Use the returned posts directly; if you call setup_postdata() yourself, restore context afterward |
Customize the main query with pre_get_posts
The pre_get_posts action fires after WordPress has created query variables but before it executes the database query. The callback receives the query object that is about to run, so you can change its parameters before SQL is generated.
Free tools Windows power users keep installed
One-click scans. No signup required.
Always target the intended query. A site may run separate queries for the main page, a sidebar, a footer, an embedded component, a REST request, or a plugin feature. Changing every query can produce unexpected results.
<?php
function my_archive_size( $query ) {
if ( ! is_admin()
&& $query->is_main_query()
&& $query->is_archive() ) {
$query->set( 'posts_per_page', 15 );
}
}
add_action( 'pre_get_posts', 'my_archive_size' );
?>What each guard does
! is_admin()limits the change to front-end requests rather than the administration area.$query->is_main_query()ensures that only the page’s primary query is changed.$query->is_archive()restricts the rule to archive requests.$query->set( 'posts_per_page', 15 )changes the archive size before the query runs.
Use conditional methods on the passed $query object. A global conditional or an unqualified callback can target the wrong query at the time the hook runs.
Pagination considerations
When you alter an archive’s main query, WordPress still treats it as the page’s paginated query. Keep the query’s normal pagination variables intact and test the first, middle, and last pages. Avoid adding an offset unless you also design how page counts and navigation will be calculated; an offset-based design can make posts disappear between pages.
Create a secondary Loop with WP_Query
Use a secondary query when the page needs another group of posts in addition to the main content, such as a “News” list in a sidebar or related posts below an article. WP_Query supplies its own have_posts() and the_post() methods.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Scan for outdated or missing drivers - takes under a minute3Repair Windows errors before they cause bigger problemsRank #3
- [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
- [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
- [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
- [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
- [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by
<?php
$related = new WP_Query( array(
'posts_per_page' => 5,
'category_name' => 'news',
) );
if ( $related->have_posts() ) :
while ( $related->have_posts() ) :
$related->the_post();
the_title( '<h2>', '</h2>' );
endwhile;
else :
echo '<p>No related posts found.</p>';
endif;
wp_reset_postdata();
?>Why the object methods matter
The loop calls $related->have_posts() and $related->the_post(), not the global functions, so the iteration is tied to the secondary query. Inside the body, the ordinary template tags can still be used because the_post() sets the current global post to the secondary result.
Reset immediately after the secondary loop
Calling the_post() changes the global post context. wp_reset_postdata() restores the context associated with the main query. Put it immediately after the secondary loop, before rendering any markup that depends on the page’s original post, author, title, or permalink.
Keep the empty branch
A category may contain fewer posts than requested, or none at all. The if/else structure prevents an empty component from failing silently and gives you a place to explain that no matching posts were found.
Use get_posts() for a straightforward additional list
get_posts( $args ) returns posts from a separate query and does not alter the main Loop. It is useful when you want to iterate over returned post objects yourself and do not need the full control of a persistent WP_Query object.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
<?php
$news_posts = get_posts( array(
'posts_per_page' => 5,
'category_name' => 'news',
) );
if ( $news_posts ) :
echo '<ul>';
foreach ( $news_posts as $news_post ) :
echo '<li>';
echo esc_html( get_the_title( $news_post ) );
echo '</li>';
endforeach;
echo '</ul>';
else :
echo '<p>No news posts found.</p>';
endif;
?>This pattern reads each returned object explicitly. If you instead call setup_postdata() to make template tags operate on one of these objects, restore the previous context when finished.
Rank #4
- Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
- Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
- All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
- Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
- Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.
Why query_posts() is an anti-pattern
The official Developer Reference states: “This function will completely override the main query and isn’t intended for use by plugins or themes.” That behavior is the reason replacing the main query with query_posts() is unsafe.
A call to query_posts() can discard query variables derived from the URL and interfere with pagination. It also performs work that the main query has already done, then substitutes a new result set where the template and navigation expected the original one.
Choose the alternative that matches the requirement:
The Tool Desk
Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →- Filtering or resizing the page’s archive/search results: modify the existing query in
pre_get_posts. - Showing another group of posts: run
new WP_Query( $args )orget_posts( $args )in the component that needs it. - Changing what a single template displays: first check whether template selection, conditional markup, or a targeted hook solves the problem without replacing the query.
Global post state: the source of many Loop bugs
WordPress template tags often read global state rather than receiving a post object as an argument. The current state normally belongs to the main query, but every call to a secondary query’s the_post() changes it temporarily.
Symptoms of a missing reset include a page heading showing a related post’s title, an author link pointing to the wrong person, or a permalink in the main content resolving to the last item in a sidebar list. The fix is structural: finish the secondary Loop, call wp_reset_postdata(), and only then render markup that relies on the main post.
For multiple secondary loops, reset after each one. Do not assume that a later query will automatically restore the page’s original context.
Build a customized Loop safely: a decision process
- Identify the target. Decide whether you are changing the posts that define the requested page or adding a separate list.
- Choose the timing. Use
pre_get_postsfor changes before SQL runs; useWP_Queryorget_posts()when the template needs an additional result set. - Constrain the scope. For
pre_get_posts, combine front-end, main-query, and request-type checks so unrelated queries remain untouched. - Write an empty state. Every query that can return zero posts needs an
elsebranch or an equivalent check. - Preserve pagination. Let the main query manage its page variables when filtering archives. Treat offsets as a separate pagination design, not a quick addition.
- Restore context. After a secondary loop calls
the_post(), runwp_reset_postdata()before using main-query template tags. - Test boundaries. Check an empty result, fewer results than requested, a full result page, and the final pagination page. For nested components, verify every title, author, and permalink after each reset.
Common failure modes and fixes
The archive shows the wrong number of posts
Check that the callback runs only for the intended main archive query and that the value is set before the query executes. An unconditional pre_get_posts callback can also modify a sidebar or another custom query.
Recommended Free Tools
Pagination links skip or repeat posts
Look for query_posts() or an offset added without a matching pagination strategy. Move archive changes to pre_get_posts and preserve the main query’s pagination variables.
The main title changes after a related-posts component
The secondary loop probably called the_post() without a following wp_reset_postdata(). Add the reset directly after the secondary loop.
A custom list is empty even though matching posts exist
Confirm that the query arguments describe the intended category or other constraint, that the loop uses the same query object that was created, and that the empty branch is not being triggered by an earlier cursor check.
Output tags show no post data
Ensure that the_post() runs before the_title(), the_content(), or other template tags. The check performed by have_posts() does not itself prepare a current post.
A compact comparison of the three approaches
| Approach | Best use | Advantages | Risks or responsibilities |
|---|---|---|---|
pre_get_posts |
Adjust the requested page’s main archive, search, or other query before execution | Works with the existing main query and its pagination model | Requires precise conditional checks; an over-broad callback affects unrelated queries |
WP_Query |
Build a fully controlled secondary Loop | Provides query-specific methods and arguments for an additional list | the_post() changes global post context; call wp_reset_postdata() |
get_posts() |
Retrieve a simple additional collection | Does not alter the main Loop and returns post objects directly | You handle iteration and any post-data setup explicitly |
query_posts() |
Not recommended for theme or plugin customization | None that outweighs replacing the existing main query | Can override URL-derived variables and disrupt pagination |
What the official guidance does—and does not—establish
The documented Loop behavior explains query state, post setup, secondary-loop resets, and the dangers of replacing the main query. It does not establish a universal maximum number of posts, a general performance benchmark, or a single “best” query size for every site. Performance depends on the query, database, theme, plugins, and hosting environment; choose arguments for the page’s actual content and test the resulting request.
The safest customization is therefore the smallest change that matches the target: modify the existing main query before it runs, or isolate an additional list in its own query and restore global state immediately afterward.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
