Title: the_block_template_skip_link
Published: July 20, 2021
Last modified: May 20, 2026

---

# the_block_template_skip_link()

## In this article

 * [Source](https://developer.wordpress.org/reference/functions/the_block_template_skip_link/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/functions/the_block_template_skip_link/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/functions/the_block_template_skip_link/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/functions/the_block_template_skip_link/?output_format=md#wp--skip-link--target)

This function has been deprecated since 6.4.0. Use wp_enqueue_block_template_skip_link()
instead.

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

Prints the skip-link script & styles.

## 󠀁[Source](https://developer.wordpress.org/reference/functions/the_block_template_skip_link/?output_format=md#source)󠁿

    ```php
    function the_block_template_skip_link() {
    	_deprecated_function( __FUNCTION__, '6.4.0', 'wp_enqueue_block_template_skip_link()' );

    	global $_wp_current_template_content;

    	// Early exit if not a block theme.
    	if ( ! current_theme_supports( 'block-templates' ) ) {
    		return;
    	}

    	// Early exit if not a block template.
    	if ( ! $_wp_current_template_content ) {
    		return;
    	}
    	?>

    	<?php
    	/**
    	 * Print the skip-link styles.
    	 */
    	?>
    	<style id="skip-link-styles">
    		.skip-link.screen-reader-text {
    			border: 0;
    			clip-path: inset(50%);
    			height: 1px;
    			margin: -1px;
    			overflow: hidden;
    			padding: 0;
    			position: absolute !important;
    			width: 1px;
    			/* Many screen reader and browser combinations announce broken words as they would appear visually. */
    			word-wrap: normal !important;
    			word-break: normal !important;
    		}

    		.skip-link.screen-reader-text:focus {
    			background-color: #eee;
    			clip-path: none;
    			color: #444;
    			display: block;
    			font-size: 1em;
    			height: auto;
    			left: 5px;
    			line-height: normal;
    			padding: 15px 23px 14px;
    			text-decoration: none;
    			top: 5px;
    			width: auto;
    			z-index: 100000;
    		}
    	</style>
    	<?php
    	/**
    	 * Print the skip-link script.
    	 */
    	?>
    	<script>
    	( function() {
    		var skipLinkTarget = document.querySelector( 'main' ),
    			sibling,
    			skipLinkTargetID,
    			skipLink;

    		// Early exit if a skip-link target can't be located.
    		if ( ! skipLinkTarget ) {
    			return;
    		}

    		/*
    		 * Get the site wrapper.
    		 * The skip-link will be injected in the beginning of it.
    		 */
    		sibling = document.querySelector( '.wp-site-blocks' );

    		// Early exit if the root element was not found.
    		if ( ! sibling ) {
    			return;
    		}

    		// Get the skip-link target's ID, and generate one if it doesn't exist.
    		skipLinkTargetID = skipLinkTarget.id;
    		if ( ! skipLinkTargetID ) {
    			skipLinkTargetID = 'wp--skip-link--target';
    			skipLinkTarget.id = skipLinkTargetID;
    		}

    		// Create the skip link.
    		skipLink = document.createElement( 'a' );
    		skipLink.classList.add( 'skip-link', 'screen-reader-text' );
    		skipLink.href = '#' + skipLinkTargetID;
    		skipLink.innerHTML = '<?php /* translators: Hidden accessibility text. */ esc_html_e( 'Skip to content' ); ?>';

    		// Inject the skip link.
    		sibling.parentElement.insertBefore( skipLink, sibling );
    	}() );
    	</script>
    	<?php
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/deprecated.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/deprecated.php#L6143)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/deprecated.php#L6143-L6241)

## 󠀁[Related](https://developer.wordpress.org/reference/functions/the_block_template_skip_link/?output_format=md#related)󠁿

| Uses | Description | 
| [esc_html_e()](https://developer.wordpress.org/reference/functions/esc_html_e/)`wp-includes/l10n.php` |

Displays translated text that has been escaped for safe use in HTML output.

  | 
| [current_theme_supports()](https://developer.wordpress.org/reference/functions/current_theme_supports/)`wp-includes/theme.php` |

Checks a theme’s support for a given feature.

  | 
| [_deprecated_function()](https://developer.wordpress.org/reference/functions/_deprecated_function/)`wp-includes/functions.php` |

Marks a function as deprecated and inform when it has been used.

  |

[Show 1 more](https://developer.wordpress.org/reference/functions/the_block_template_skip_link/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/functions/the_block_template_skip_link/?output_format=md#)

## 󠀁[Changelog](https://developer.wordpress.org/reference/functions/the_block_template_skip_link/?output_format=md#changelog)󠁿

| Version | Description | 
| [6.4.0](https://developer.wordpress.org/reference/since/6.4.0/) | Deprecated. Use [wp_enqueue_block_template_skip_link()](https://developer.wordpress.org/reference/functions/wp_enqueue_block_template_skip_link/) instead. | 
| [5.8.0](https://developer.wordpress.org/reference/since/5.8.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fthe_block_template_skip_link%2F)
before being able to contribute a note or feedback.