Title: wp_welcome_panel
Published: April 25, 2014
Last modified: February 24, 2026

---

# wp_welcome_panel()

## In this article

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

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

Displays a welcome panel to introduce users to WordPress.

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

    ```php
    function wp_welcome_panel() {
    	list( $display_version ) = explode( '-', wp_get_wp_version() );
    	$can_customize           = current_user_can( 'customize' );
    	$is_block_theme          = wp_is_block_theme();
    	?>
    	<div class="welcome-panel-content">
    	<div class="welcome-panel-header">
    		<div class="welcome-panel-header-image">
    			<?php echo file_get_contents( dirname( __DIR__ ) . '/images/dashboard-background.svg' ); ?>
    		</div>
    		<h2><?php _e( 'Welcome to WordPress!' ); ?></h2>
    		<p>
    			<a href="<?php echo esc_url( admin_url( 'about.php' ) ); ?>">
    			<?php
    				/* translators: %s: Current WordPress version. */
    				printf( __( 'Learn more about the %s version.' ), esc_html( $display_version ) );
    			?>
    			</a>
    		</p>
    	</div>
    	<div class="welcome-panel-column-container">
    		<div class="welcome-panel-column">
    			<svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
    				<rect width="48" height="48" rx="4" fill="#1E1E1E"/>
    				<path fill-rule="evenodd" clip-rule="evenodd" d="M32.0668 17.0854L28.8221 13.9454L18.2008 24.671L16.8983 29.0827L21.4257 27.8309L32.0668 17.0854ZM16 32.75H24V31.25H16V32.75Z" fill="white"/>
    			</svg>
    			<div class="welcome-panel-column-content">
    				<h3><?php _e( 'Author rich content with blocks and patterns' ); ?></h3>
    				<p><?php _e( 'Block patterns are pre-configured block layouts. Use them to get inspired or create new pages in a flash.' ); ?></p>
    				<a href="<?php echo esc_url( admin_url( 'post-new.php?post_type=page' ) ); ?>"><?php _e( 'Add a new page' ); ?></a>
    			</div>
    		</div>
    		<div class="welcome-panel-column">
    			<svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
    				<rect width="48" height="48" rx="4" fill="#1E1E1E"/>
    				<path fill-rule="evenodd" clip-rule="evenodd" d="M18 16h12a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2H18a2 2 0 0 1-2-2V18a2 2 0 0 1 2-2zm12 1.5H18a.5.5 0 0 0-.5.5v3h13v-3a.5.5 0 0 0-.5-.5zm.5 5H22v8h8a.5.5 0 0 0 .5-.5v-7.5zm-10 0h-3V30a.5.5 0 0 0 .5.5h2.5v-8z" fill="#fff"/>
    			</svg>
    			<div class="welcome-panel-column-content">
    			<?php if ( $is_block_theme ) : ?>
    				<h3><?php _e( 'Customize your entire site with block themes' ); ?></h3>
    				<p><?php _e( 'Design everything on your site &#8212; from the header down to the footer, all using blocks and patterns.' ); ?></p>
    				<a href="<?php echo esc_url( admin_url( 'site-editor.php' ) ); ?>"><?php _e( 'Open site editor' ); ?></a>
    			<?php else : ?>
    				<h3><?php _e( 'Start Customizing' ); ?></h3>
    				<p><?php _e( 'Configure your site&#8217;s logo, header, menus, and more in the Customizer.' ); ?></p>
    				<?php if ( $can_customize ) : ?>
    					<a class="load-customize hide-if-no-customize" href="<?php echo wp_customize_url(); ?>"><?php _e( 'Open the Customizer' ); ?></a>
    				<?php endif; ?>
    			<?php endif; ?>
    			</div>
    		</div>
    		<div class="welcome-panel-column">
    			<svg width="48" height="48" viewBox="0 0 48 48" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false">
    				<rect width="48" height="48" rx="4" fill="#1E1E1E"/>
    				<path fill-rule="evenodd" clip-rule="evenodd" d="M31 24a7 7 0 0 1-7 7V17a7 7 0 0 1 7 7zm-7-8a8 8 0 1 1 0 16 8 8 0 0 1 0-16z" fill="#fff"/>
    			</svg>
    			<div class="welcome-panel-column-content">
    			<?php if ( $is_block_theme ) : ?>
    				<h3><?php _e( 'Switch up your site&#8217;s look & feel with Styles' ); ?></h3>
    				<p><?php _e( 'Tweak your site, or give it a whole new look! Get creative &#8212; how about a new color palette or font?' ); ?></p>
    				<a href="<?php echo esc_url( admin_url( '/site-editor.php?path=%2Fwp_global_styles' ) ); ?>"><?php _e( 'Edit styles' ); ?></a>
    			<?php else : ?>
    				<h3><?php _e( 'Discover a new way to build your site.' ); ?></h3>
    				<p><?php _e( 'There is a new kind of WordPress theme, called a block theme, that lets you build the site you&#8217;ve always wanted &#8212; with blocks and styles.' ); ?></p>
    				<a href="<?php echo esc_url( __( 'https://wordpress.org/documentation/article/block-themes/' ) ); ?>"><?php _e( 'Learn about block themes' ); ?></a>
    			<?php endif; ?>
    			</div>
    		</div>
    	</div>
    	</div>
    	<?php
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-admin/includes/dashboard.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-admin/includes/dashboard.php#L2062)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-admin/includes/dashboard.php#L2062-L2133)

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

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

Returns the current WordPress version.

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

Returns whether the active theme is a block-based theme or not.

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

Returns a URL to load the Customizer.

  | 
| [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.

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

Displays translated text.

  | 
| [__()](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.

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

Escaping for HTML blocks.

  | 
| [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.

  |

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

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

| Version | Description | 
| [5.9.0](https://developer.wordpress.org/reference/since/5.9.0/) | Send users to the Site Editor if the active theme is block-based. | 
| [3.3.0](https://developer.wordpress.org/reference/since/3.3.0/) | Introduced. |

## User Contributed Notes

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