the_attachment_link( int|WP_Post $id, bool $fullsize = false, bool $deprecated = false, bool $permalink = false )

Display an attachment page link using an image or icon.

Parameters Parameters


(int|WP_Post) (Optional) Post ID or post object.


(bool) (Optional) Whether to use full size.

Default value: false


(bool) (Optional) Deprecated. Not used.

Default value: false


(bool) (Optional) Whether to include permalink.

Default value: false

Top ↑

More Information More Information

Outputs an HTML hyperlink to an attachment file or page, containing either

  1. A full-size image or thumbnail for image attachments; or
  2. The attachment’s title (as text) for non-image attachments

If no attachment can be found, the function displays the string Missing Attachment.

Use wp_get_attachment_link() instead if you just want to get the hyperlink, not print it.

Top ↑

Source Source

File: wp-includes/post-template.php

function the_attachment_link( $id = 0, $fullsize = false, $deprecated = false, $permalink = false ) {
	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, '2.5.0' );

	if ( $fullsize ) {
		echo wp_get_attachment_link( $id, 'full', $permalink );
	} else {
		echo wp_get_attachment_link( $id, 'thumbnail', $permalink );

Top ↑

Changelog Changelog

Version Description
2.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

Top ↑

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