Custom Welcome Guide


Create interactive step-by-step introduction tours/tutorials/walkthrough guides for your admin users or content creators through a friendly user admin interface. Inspired by the Guide Gutenberg component that pops up when you open the Block editor for the first time. Customize the default welcome message or add as many custom guides as you want. Maybe you are a WordPress agency or a freelancer who needs a simple and user-friendly way to showcase to your clients the cms options that you have built in the WordPress admin? Or you work with an editorial team and you want to make the publishing experience as easy and smooth as possible? This plugin will empower you to display custom welcome messages and tips to your admin users in a fun, easy and much more interactive way.

Plugin Options

You can create, edit and delete guides and add as many sub-guides (popups) to them as you wish via the Guides tab in the WordPress admin. You can choose whether to display a list of all the guides inside the post editor, page editor or only on a specific custom post type. If you wish, you can also remove or override the default WordPress Block Editor welcome tips.

How it Works

Navigate to the Guides tab in the WordPress admin and add a new Guide. You can then assign sub-guides (steps) to the guide you have just created. Just add a new guide and link it to the parent guide via the Page Attributes tab from the bottom right corner in the Block Editor’s sidebar. In this way, the latter guide will become a sub-guide to the first guide (parent guide) that you have created. Now, when you create (or edit) a post or a page in the WordPress admin, you will see a new “Welcome Guide” tab in the Block Editor’s sidebar, right under the Status & Visibility tab. Once you expand it, you will see a list with all the parent guides that you have created. When you click on a parent guide, you will see a tour with all the sub-guides that you have associated to the parent guide via the Page Attributes tab.


  • Plugin’s Settings Page
  • List of all the Guides in the Block Editor’s Sidebar
  • Adding a sub-guide (popup) to a guide
  • Custom Welcome Guide Popup


  1. Upload the plugin files to the /wp-content/plugins/admin-user-guide directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress


How to create a guide?

From your WordPress admin dashboard, navigate to Guides tab and add a new guide by clicking on the “Add New” button.

How to add an image to the guide?

When creating or editing a guide, you can optionally assign a featured image to it by going to the featured image tab in the Block Editor’s sidebar.

How to add additional popups to the guide?

To add more screens (steps/sub-guides) to the guide, you need to create a sub-guide and link it to the parent guide. Create a new guide and link it to the parent guide via the Page Attributes tab from the right sidebar in the Block Editor.

Can I create more than one guide?

Absolutely! You can create as many guides as you want and link as many screens to them as you wish. A list with all the guides will be visible in the Welcome Guide tab from the block editor’s sidebar.

How to run a guide?

When creating or editing a post, a “Welcome Guide” tab will be visible in the Block Editor’s sidebar, right below the Status & Visibility tab. Expand the tab and you will see a list with all the guides. You can also create a featured Guide, that will popup the first time the user opens the Block Editor. Please check the next question for more details.

Can I customize the default Welcome Guide modal?

Deffinitely! When an editor opens the Block Editor for the first time, the default Welcome Guide dialog pops up. To add a custom welcome guide message and replace the default one, simply go to the plugin’s settings page (Guides => Settings) and select a featured guide from the dropdown list.

Can I disable the guides for a specific post type?

Sure, you can remove the list with the guides in the Block Editor’s sidebar for a specific post type, e.g. pages. Just go to the plugin’s settings page and remove the tick on the toggle button for the respective post type.

Can I show a guide that pops up in all the admin pages?

Since version 1.0.1 you can! In the plugin’s settings page, select a featured guide and enable the option “show the featured guide in The whole WordPress Admin”.

Can I run the guides from the frontend?

No, the scope of the plugin is to help your admin users or editors with the cms options and currently runs only from the WordPress admin.

Does the plugin work with the Classic Editor?

The featured guide should work as expected, however you will not be able to see a list of guides in the post editor’s sidebar. The plugin uses the rest api and pre-built Gutenberg components from WordPress core. To take full advantage of all the plugin options, please use the Block editor.


ستمبر 16, 2021
Good job. I like this plugin.
Read all 1 review

Contributors & Developers

“Custom Welcome Guide” is open source software. The following people have contributed to this plugin.


Translate “Custom Welcome Guide” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


1.0.9 – September 2022

Remove Freemius SDK

1.0.8 – September 2022

Fix open the sidebar panel by default and improve ui

1.0.7 – March 2022

Fix js error for admin pages without the block editor

1.0.6 – March 2022

Improve UI and change editor’s panel initial state to open

1.0.5 – February 2022

Add Freemius SDK

1.0.4 – December 2021

Add dependencies dynamically via the build folder
toggle the option to display tour in the whole admin based on the featured tour option

1.0.3 – September 2021

Show the guide to non-admin users

1.0.2 – September 2021

Provide support for wp 5.4

1.0.1 – September 2021

Add option to show the featured guide in the whole WordPress Admin

1.0.0 – September 2021

  • First Release