previous_image_link( string|array $size = 'thumbnail', string $text = false )

Displays previous image link that has the same post parent.

Description Description

See also See also

Top ↑

Parameters Parameters


(string|array) (Optional) Image size. Accepts any valid image size, an array of width and height values in pixels (in that order), 0, or 'none'. 0 or 'none' will default to 'post_title' or $text.

Default value: 'thumbnail'


(string) (Optional) Link text.

Default value: false

Top ↑

Source Source

File: wp-includes/media.php

function previous_image_link( $size = 'thumbnail', $text = false ) {
	adjacent_image_link( true, $size, $text );

Top ↑

Changelog Changelog

Version Description
2.5.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 3 content
    Contributed by Codex

    Define a Custom Image Size

    <?php previous_image_link( array( 37, 37 ) ); ?>

    Please note that passing an array as the first parameter will not create a new image; It will use the web browser to re-size the thumbnail to fit into the given dimensions. Although this works in a pinch, it produces a rather distorted view of the image due to the fact that browsers have no way of re sampling the re-sized image.

You must log in before being able to contribute a note or feedback.