Rewrites WordPress image URLs to use Tachyon

Installs: 207 554

Dependents: 2

Suggesters: 0

Security: 0

Stars: 81

Watchers: 20

Forks: 15

Open Issues: 16


0.11.9 2024-04-15 12:52 UTC


Faster than light image processing. Inspired / forked from Photon.
Build status Coverage via
A Human Made project. Maintained by @joehoyle. 68747470733a2f2f686d6e2e6d642f636f6e74656e742f7468656d65732f686d6e6d642f6173736574732f696d616765732f686d2d6c6f676f2e737667

Tachyon is an image resizing service built to be used with Amazon S3 as the image backend, AWS Lambda (or any node.js server) to process images using sharp, and sits behind a CDN such as CloudFront or CloudFlare.

This plugin handles modifying WordPress image URLs to use a Tachyon service instance.


  1. Upload and enable this plugin.
  2. Add define( 'TACHYON_URL', 'https://your.tachyon.url/path/to/uploads' ) to your wp-config.php file.


Typically the above steps are all you need to do however you can use the following public facing functions and filters.


tachyon_url( string $image_url, array $args = [] )

This function returns the Tachyon URL for a given image hosted on Amazon S3.

$image_url = '';
$args      = [
	'resize'  => '300,300',
	'quality' => 90

$url = tachyon_url( $image_url, $args );


The following filters allow you to modify the output and behaviour of the plugin.


Defaults to true. You can override this by adding the following code to a plugin or your theme's functions.php:

add_filter( 'tachyon_disable_in_admin', '__return_false' );


Defaults to false. Provides a way of preventing Tachyon from being applied to images retrieved from WordPress Core at the lowest level, you might use this if you wanted to use tachyon_url() manually in specific cases.

add_filter( 'tachyon_override_image_downsize', '__return_true' );


Allows skipping the Tachyon URL for a given image URL. Defaults to false.

add_filter( 'tachyon_skip_for_url', function ( $skip, $image_url, $args ) {
	if ( strpos( $image_url, 'original' ) !== false ) {
		return true;
	return $skip;
}, 10, 3 );


Filters the Tachyon image URL excluding the query string arguments. You might use this to shard Tachyon requests across multiple instances of the service for example.

add_filter( 'tachyon_pre_image_url', function ( $image_url, $args ) {
	if ( rand( 1, 2 ) === 2 ) {
		$image_url = str_replace( TACHYON_URL, TACHYON_URL_2, $image_url );
	return $image_url;
}, 10, 2 );


Filters the query string parameters appended to the tachyon image URL.

add_filter( 'tachyon_pre_args', function ( $args ) {
	if ( isset( $args['resize'] ) ) {
		$args['crop_strategy'] = 'smart';
	return $args;
} );


Defaults to true. width & height attributes on image tags are removed by default to prevent aspect ratio distortion that can happen in some unusual cases where srcset sizes have different aspect ratios.

add_filter( 'tachyon_remove_size_attributes', '__return_true' );


Created by Human Made for high volume and large-scale sites, such as Happytables. We run Tachyon on sites with millions of monthly page views, and thousands of sites.

Written and maintained by Joe Hoyle.

Tachyon is forked from Photon by Automattic Inc. As Tachyon is not an all-purpose image resizer, rather it uses a media library in Amazon S3, it has a different use case to Photon.

Interested in joining in on the fun? Join us, and become human!