previous_image_link() – Function | Developer.WordPress.org

Displays previous image link that has the same post parent.

Parameters

$sizestring|int[]optional: Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order). Default 'thumbnail'.
Default:'thumbnail'
$textstring|falseoptional: Link text.
Default:false

More Information

Usage:

Typically uses in attachment.php. In the WordPress default theme Twenty Eleven and Twenty Twelve, it is used in image.php.

previous_image_link( $size, $text );

Notes:

This creates a link to the previous image attached to the current post. Whenever a series of images are linked to the attachment page, it will put a ‘previous image link’ with the images when viewed in the attachment page.

Source

	wp_enqueue_script( 'mediaelement-vimeo' );
}

View all references View on Trac View on GitHub

Changelog

Version	Description
2.5.0	Introduced.

User Contributed Notes

Skip to note 6 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Basic Examples

Default Usage
```
<?php previous_image_link(); ?>
```
Working example
```
<div class="alignleft"><?php previous_image_link(); ?></div>
```
Log in to add feedback
Skip to note 7 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Choose a Recognized Image Size
```
<?php previous_image_link( 'thumbnail' ); ?>
<?php previous_image_link( 'medium' ); ?>
<?php previous_image_link( 'large' ); ?>
<?php previous_image_link( 'fullsize' ); ?>
```
Log in to add feedback
Skip to note 8 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
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.
Log in to add feedback
Skip to note 9 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Use the Image’s Title as Link Text

If a Boolean false is used as the first parameter, The function will use the image’s title value (as set through the Media Library).
```
<?php previous_image_link( false ); ?>
<?php previous_image_link( 0 ); ?>
```
Log in to add feedback
Skip to note 10 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Use a Custom String as Link Text

To specify a custom string as the link text, pass a Boolean false as the first parameter and the custom text as a string to the second parameter.
```
<?php previous_image_link( false, 'Previous Image' ); ?>
```
Log in to add feedback

previous_image_link( string|int[] $size = 'thumbnail', string|false $text = false )

In this article