Title: wp_register Published: April 25, 2014 Last modified: August 20, 2026 --- # wp_register( string $before = '
  • ', string $after = '
    • ', bool $display = true ): void|string ## In this article * [Description](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#description) * [Parameters](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#parameters) * [Return](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#return) * [More Information](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#more-information) * [Source](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#source) * [Hooks](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#hooks) * [Related](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#related) * [Changelog](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#changelog) * [User Contributed Notes](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#user-contributed-notes) [ Back to top](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#wp--skip-link--target) Displays the Registration or Admin link. ## 󠀁[Description](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#description)󠁿 Display a link which allows the user to navigate to the registration page if not logged in and registration is enabled or to the dashboard if logged in. ## 󠀁[Parameters](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#parameters)󠁿 `$before`stringoptional Text to output before the link. Default `
  • `. Default:`'
  • '` `$after`stringoptional Text to output after the link. Default `
    • `. Default:`''` `$display`booloptional Default to echo and not return the link. Default:`true` ## 󠀁[Return](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#return)󠁿 void|string Void if `$display` argument is true, registration or admin link if ` $display` is false. ## 󠀁[More Information](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#more-information)󠁿 The “Register” link is not offered if the [Administration](https://wordpress.org/support/article/administration-screens/) > [Settings](https://wordpress.org/support/article/administration-screens/) > [General](https://wordpress.org/support/article/settings-general-screen/) > **Membership: Anyone can register** box is not checked. ## 󠀁[Source](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#source)󠁿 ```php function wp_register( $before = '
  • ', $after = '
    • ', $display = true ) { if ( ! is_user_logged_in() ) { if ( get_option( 'users_can_register' ) ) { $link = $before . '' . __( 'Register' ) . '' . $after; } else { $link = ''; } } elseif ( current_user_can( 'read' ) ) { $link = $before . '' . __( 'Site Admin' ) . '' . $after; } else { $link = ''; } /** * Filters the HTML link to the Registration or Admin page. * * Users are sent to the admin page if logged-in, or the registration page * if enabled and logged-out. * * @since 1.5.0 * * @param string $link The HTML code for the link to the Registration or Admin page. */ $link = apply_filters( 'register', $link ); if ( $display ) { echo $link; } else { return $link; } } ``` [View all references](https://developer.wordpress.org/reference/files/wp-includes/general-template.php/) [View on Trac](https://core.trac.wordpress.org/browser/tags/7.1/src/wp-includes/general-template.php#L907) [View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.1/src/wp-includes/general-template.php#L907-L937) ## 󠀁[Hooks](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#hooks)󠁿 [apply_filters( ‘register’, string $link )](https://developer.wordpress.org/reference/hooks/register/) Filters the HTML link to the Registration or Admin page. ## 󠀁[Related](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#related)󠁿 | Uses | Description | | [wp_registration_url()](https://developer.wordpress.org/reference/functions/wp_registration_url/)`wp-includes/general-template.php` | Returns the URL that allows the user to register on the site. | | [current_user_can()](https://developer.wordpress.org/reference/functions/current_user_can/)`wp-includes/capabilities.php` | Returns whether the current user has the specified capability. | | [__()](https://developer.wordpress.org/reference/functions/__/)`wp-includes/l10n.php` | Retrieves the translation of $text. | | [esc_url()](https://developer.wordpress.org/reference/functions/esc_url/)`wp-includes/formatting.php` | Checks and cleans a URL. | | [is_user_logged_in()](https://developer.wordpress.org/reference/functions/is_user_logged_in/)`wp-includes/pluggable.php` | Determines whether the current visitor is a logged in user. | | [admin_url()](https://developer.wordpress.org/reference/functions/admin_url/)`wp-includes/link-template.php` | Retrieves the URL to the admin area for the current site. | | [apply_filters()](https://developer.wordpress.org/reference/functions/apply_filters/)`wp-includes/plugin.php` | Calls the callback functions that have been added to a filter hook. | | [get_option()](https://developer.wordpress.org/reference/functions/get_option/)`wp-includes/option.php` | Retrieves an option value based on an option name. | [Show 6 more](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#) [Show less](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#) | Used by | Description | | [WP_Widget_Meta::widget()](https://developer.wordpress.org/reference/classes/wp_widget_meta/widget/)`wp-includes/widgets/class-wp-widget-meta.php` | Outputs the content for the current Meta widget instance. | ## 󠀁[Changelog](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#changelog)󠁿 | Version | Description | | [1.5.0](https://developer.wordpress.org/reference/since/1.5.0/) | Introduced. | ## 󠀁[User Contributed Notes](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#user-contributed-notes)󠁿 1. [Skip to note 3 content](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#comment-content-524) 2. [Codex](https://profiles.wordpress.org/codex/) [ 11 years ago ](https://developer.wordpress.org/reference/functions/wp_register/#comment-524) 3. [You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fwp_register%2F%23comment-524) Vote results for this note: 0[You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fwp_register%2F%23comment-524) 4. **Default Usage** `wp_register` displays the link in list format `
  • `. 5. ```php ``` 6. [Log in to add feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fwp_register%2F%3Freplytocom%3D524%23feedback-editor-524) 7. [Skip to note 4 content](https://developer.wordpress.org/reference/functions/wp_register/?output_format=md#comment-content-525) 8. [Codex](https://profiles.wordpress.org/codex/) [ 11 years ago ](https://developer.wordpress.org/reference/functions/wp_register/#comment-525) 9. [You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fwp_register%2F%23comment-525) Vote results for this note: 0[You must log in to vote on the helpfulness of this note](https://login.wordpress.org?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fwp_register%2F%23comment-525) 10. **Display Without Text Before or After** The following code example displays the “Register” or “Site Admin” link with no text in before or after parameters. 11. ```php ``` 12. When not logged in the following HTML is produced: 13. ```php RegisterSite Admin ``` 16. [Log in to add feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fwp_register%2F%3Freplytocom%3D525%23feedback-editor-525) You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Ffunctions%2Fwp_register%2F) before being able to contribute a note or feedback.