Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.
WordPress transients are temporary, named cache values. Your code writes one with set_transient(), reads it with get_transient(), and removes it with delete_transient(). The expiration is a maximum lifetime, not a promise that the value will remain available until then. The WP-CLI command wp transient delete invalidates transients only: it does not automatically clear page caches, a CDN, a reverse proxy, a browser cache, or a plugin’s separate cache. Use a key-specific delete when one result is stale, --expired for cleanup, and --all only when a broad regeneration is intentional. On multisite, choose the network scope explicitly.
What is a WordPress transient, and why does it matter?
A transient is a value stored temporarily under a string key so WordPress can reuse work across requests. Typical examples include a remote API response, a calculated list of products, a rendered fragment, or an expensive database query. Instead of rebuilding that result on every page load, code checks the transient first and regenerates it only after a miss.
As an Amazon Associate I earn from qualifying purchases.
Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minutePC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11The Transients API is designed to store information “temporarily … across page loads.” Unlike a permanent option, a transient is expected to become disposable. It may vanish before its requested lifetime, so application logic must always have a regeneration path.
WordPress exposes three lifecycle functions:
set_transient()writes or replaces a value.get_transient()retrieves the value or reports a miss.delete_transient()removes one named value.
Transient values can be arrays or objects; the API serializes complex PHP values for storage and restores them when read. The documented maximum name length for the database-backed route is 172 characters because WordPress adds prefixes to the key.
#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
How does the transient API work?
The API follows a cache-aside pattern: read first, calculate on a miss, then save the result.
Writing a value with set_transient()
The function takes a name, a value, and an expiration in seconds:
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →$value = fetch_remote_data();
set_transient( 'weather_london', $value, 15 * MINUTE_IN_SECONDS );The expiration is expressed in seconds. Passing zero means no expiration in the function reference, although non-expiring values have different autoload implications on database-backed installs. Because a transient is disposable by design, use a finite lifetime unless you have a specific reason not to.
Reading with get_transient()
A read returns the stored value when it is present and valid. If the key is absent or expired, the return value is false:
$cached = get_transient( 'weather_london' );
if ( $cached === false ) {
$cached = fetch_remote_data();
set_transient( 'weather_london', $cached, 15 * MINUTE_IN_SECONDS );
}Use the strict comparison === false. A valid cached value can be 0, an empty string, or another falsey value; a loose check such as if ( ! $cached ) would mistake that data for a cache miss. Avoid using a plain boolean false as the only legitimate payload when your code needs to distinguish a stored value from a miss.
On the database path, WordPress checks the timeout while reading and can delete an expired value during that read. With an external object cache, expiration and eviction are handled by that cache implementation, but the API still presents a miss as false.
Removing one value with delete_transient()
To invalidate a known key from PHP, call:
delete_transient( 'weather_london' );The function returns a boolean result. Without a persistent object cache, WordPress removes the transient option and its associated timeout option. With an external object cache, WordPress uses the object-cache deletion path instead.
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
How long do transients really last?
An expiration is a ceiling, not a guarantee of availability. WordPress documentation explicitly notes that transients can expire earlier because of external object-cache behavior or database changes, but they will not return their value after the requested expiration.
That means transient data must be reproducible. If an early eviction causes an outage rather than a normal recalculation, the value belongs in a more durable storage system or the regeneration code needs a fallback. Treat every read as potentially missing, even seconds after a successful write.
Expiration also does not guarantee immediate physical cleanup in every storage implementation. A database-backed transient may be removed when WordPress encounters it as expired; object-cache servers may evict it according to their own policies. Your code should care about the returned value, not assume a particular cleanup timing.
Where are transients stored?
Storage depends on the active WordPress cache implementation.
| Installation | Typical transient location | Operational implication |
|---|---|---|
| Single-site without a persistent object-cache drop-in | wp_options, with a value entry and timeout entry |
Database reads and writes handle the transient. |
| Multisite without a persistent object-cache drop-in | wp_options for site transients; wp_sitemeta for network transients |
Site and network namespaces are separate. |
| Persistent object cache enabled | The WordPress object-cache layer, commonly backed by a service such as Redis or Memcached | The transient may never be written to the database. |
This distinction matters when troubleshooting. Looking only in the database can miss a transient that is currently held by a persistent object cache. Conversely, deleting a database row does not prove that an independently managed cache layer has been purged.
What does wp transient delete actually do?
wp transient delete is the WP-CLI wrapper for transient invalidation. A targeted command removes one named key:
wp transient delete sample_keyUse that form when you know which cached result became stale—for example, after changing content, a setting, a taxonomy term, a remote response, or generated markup represented by that key. The next request that needs the value will take the miss path and regenerate it.
Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
The command’s scope is the transient layer selected by WordPress and WP-CLI. A successful deletion does not claim that a full-page cache, reverse proxy, CDN, browser cache, or plugin-specific cache was cleared. Those systems require their own documented invalidation command or control panel action.
What is the difference between --expired, --all, and --network?
The switches change either which entries are selected or which multisite namespace is addressed.
| Command | What it selects | Best use | Risk to consider |
|---|---|---|---|
wp transient delete KEY |
One named transient in the current scope | A known stale result after a content or settings change | Requires the exact key. |
wp transient delete --expired |
Expired transients in the current scope | Housekeeping when you want to remove entries that are already expired | It does not invalidate still-valid values. |
wp transient delete --all |
Every transient in the selected local scope | A deliberate broad reset or an incident that requires all values to regenerate | Many expensive queries or remote requests can run again at once. |
wp transient delete --network (with a deletion mode) |
Network/site transients in a multisite network | A stale network-wide value | It does not automatically remove each site’s local transients. |
--network changes the namespace; it is not a synonym for “all sites.” If every site-local transient must be removed on multisite, run the appropriate local-scope deletion for each site after handling network transients. Confirm the target site or network before executing a broad command.
When should you run wp transient delete KEY?
Use a targeted delete when one known cached result no longer reflects its source data. This preserves unrelated cache entries and limits the amount of regeneration work.
Recommended Free Tools
- Content updates: invalidate a key that stores a generated list or fragment built from edited posts or terms.
- Configuration changes: remove a value derived from a setting, feature flag, or integration credential.
- Taxonomy changes: clear a result whose query depends on categories, tags, or other terms.
- Remote API changes: delete a response cache when the upstream data has been corrected or its request parameters changed.
- Generated markup changes: invalidate a fragment after changing the template or rendering logic that produces it.
Best practice is to put invalidation next to the event that makes data stale. For example, a plugin can call delete_transient() from the setting-update or content-update workflow rather than asking an administrator to flush every transient.
When is --expired the right maintenance choice?
Choose --expired when the objective is cleanup, not a forced rebuild. It removes entries whose lifetimes have already ended while leaving currently valid cached results available.
This is useful for a maintenance window or a database cleanup task where you want to reduce expired-entry clutter without creating a simultaneous miss for every feature. It does not repair a still-valid but incorrect value; that key needs targeted invalidation.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
When is --all justified, and why can it hurt?
--all is a broad invalidation tool. Use it for a deliberate cache reset or an incident where identifying individual keys is impractical and you accept the resulting regeneration load.
Free tools Windows power users keep installed
One-click scans. No signup required.
After a broad delete, many requests can miss at the same time. They may repeat expensive database queries, remote API calls, or rendering work. The command reference defines the deletion scope, while the regeneration burst is an operational consequence of making every transient unavailable. Schedule the reset when traffic and upstream rate limits can tolerate it, and monitor error rates and request latency afterward.
Do not make --all your routine response to one stale page. Identify and remove the smallest affected key whenever possible.
How do multisite transient scopes work?
Multisite has both site-local and network-wide transients. Site-local values belong to an individual site; network transients are shared at the network level and use the network metadata storage path when the database is involved.
When a network transient is wrong, include --network in the WP-CLI deletion command and target the relevant key or deletion mode. If every site’s local values also need to be regenerated, process those sites separately. A network deletion alone does not reach each site’s local namespace.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Before using --all on a multisite installation, verify whether the command is operating on the current site or the network scope. A mistaken scope can leave the stale value untouched—or remove considerably more data than intended.
Why is a page still stale after deleting a transient?
Because a transient is only one cache layer. Deleting it makes the next application read regenerate that transient, but another layer may continue serving an older response.
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
- Confirm that the key you deleted is the key used by the code serving the page.
- Make one request that reaches WordPress and verify that the transient is regenerated.
- Check for a full-page cache, reverse proxy, CDN, browser cache, or plugin-specific cache in front of or beside WordPress.
- Purge the relevant layer using its own supported mechanism, if it is responsible for the stale response.
- Re-test while distinguishing an origin response from a cached response.
The transient command cannot be used as evidence that every cache in the delivery path was purged. Its documented effect stops at the selected transient namespace.
What coding patterns make transient misses safe?
Keep the miss path deterministic and cheap enough to run when the cache disappears early.
Quick wins for a faster PC:
Repair Windows errors before they cause bigger problemsFix Now →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →$key = 'catalog_featured_v2';
$value = get_transient( $key );
if ( false === $value ) {
$value = build_featured_catalog();
if ( $value !== false ) {
set_transient( $key, $value, HOUR_IN_SECONDS );
}
}
return $value;The version suffix in this example is an application convention: changing it creates a new namespace when the data shape or generation logic changes. It is not a WordPress requirement. The important rules are to check strictly for false, regenerate on a miss, and avoid treating a transient as the authoritative copy of business data.
If regeneration can be expensive, add application-level safeguards such as a short-lived lock or a fallback to a previously stored durable value. Those controls are outside the Transients API itself, but they prevent simultaneous misses from overwhelming a database or remote service.
What are the main transient API pitfalls?
- Assuming the timeout is a guarantee: external caches and database changes can remove values early.
- Using loose falsey checks:
0, an empty string, or another valid falsey payload can be mistaken for a miss. - Using oversized names: the documented database-backed limit is 172 characters after accounting for WordPress prefixes.
- Storing canonical data only in a transient: a transient can disappear at any time, so durable records belong elsewhere.
- Flushing everything for a local problem: broad invalidation creates unnecessary regeneration work.
- Expecting transient deletion to clear page delivery caches: each cache layer has an independent scope and invalidation method.
- Ignoring multisite scope: network and site-local values are different namespaces.
Which action should you choose?
| Situation | Preferred action | Reason |
|---|---|---|
| One known result is stale after a change | wp transient delete KEY |
Limits invalidation to the affected value. |
| You want to remove expired entries | wp transient delete --expired |
Cleans up expired values without discarding valid ones. |
| A broad incident requires regeneration in one scope | wp transient delete --all |
Invalidates the complete selected transient set; plan for misses. |
| A network transient is stale on multisite | Add --network |
Selects the network namespace. |
| The page remains stale afterward | Inspect and purge other cache layers | The transient command does not cover them. |
The practical rule is simple: invalidate the narrowest scope that fixes the stale data, and reserve broad deletion for cases where its regeneration cost is understood and acceptable.
Frequently Asked Questions
Can a transient be used as permanent WordPress data?
No. A transient is an optimization layer, not an authoritative record. Keep important business data in durable WordPress tables or another persistent store, and make the transient a rebuildable copy.
Will deleting a transient log users out or remove their accounts?
Normally no; transient deletion targets temporary cache values. It would affect user-visible state only if custom code incorrectly stored session or account data in transients, which is not an appropriate design for durable identity or authentication state.
What happens if two requests miss the same transient at once?
Both requests can enter the regeneration path unless the application adds its own coordination. For expensive work, use a short-lived lock or another stampede-control technique, and keep a durable fallback when one exists.
Does a zero expiration make a transient safer from eviction?
No. Zero means no expiration in the function reference, but an external object cache or database operation can still remove the value. Non-expiring database-backed values also have different autoload implications, so choose that setting deliberately.
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.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Repair Windows errors before they cause bigger problems3Fix the driver behind crashes, sound loss and screen glitches
