Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

_wp_get_attachment_relative_path( string $file )

Get the attachment path relative to the upload directory.

Description Description

Parameters Parameters


(string) (Required) Attachment file name.

Top ↑

Return Return

(string) Attachment path relative to the upload directory.

Top ↑

Source Source

File: wp-includes/media.php

function _wp_get_attachment_relative_path( $file ) {
	$dirname = dirname( $file );

	if ( '.' === $dirname ) {
		return '';

	if ( false !== strpos( $dirname, 'wp-content/uploads' ) ) {
		// Get the directory name relative to the upload directory (back compat for pre-2.7 uploads)
		$dirname = substr( $dirname, strpos( $dirname, 'wp-content/uploads' ) + 18 );
		$dirname = ltrim( $dirname, '/' );

	return $dirname;

Top ↑

Changelog Changelog

Version Description
4.4.1 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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