This website uses cookies to personalise ads and to analyse traffic ok
web design

Page scroll to id for WordPress tutorial

Basic tutorial for using “Page scroll to id” WordPress plugin on your WordPress site.

In order to use the plugin on your WordPress site (after installing and activating it), you need to do the following:

  1. Create id targets the page will scroll to or find existing id attributes in your theme to use with your links.
  2. Create links that point to those targets or enable the plugin on links that already exist in your site.

Divi WordPress Theme

Creating id targets

Creating id targets in post block editor (Gutenberg)

You can create your targets in more than one ways in the block editor, e.g. using the group block, the “Page scroll to id target” block, the shortcode block, block class attribute, HTML anchor field etc.

Create id targets using the group block

Click on the “Add block” icon and select “Group”. This will insert a general container block that can group other blocks and we can add the id on this group/general container block.

On the group block properties (right panel) you can add the id you want in the “HTML Anchor” field.

Create id targets using the shortcode block

You can use plugin’s shortcodes in the block editor. Click on the “Add block” icon and select “Shortcode”.
Add the [ps2id id='section-1'/] in the shortcode field to create a target with id section-1.

You can also use the [ps2id_wrap] shortcode accordingly.

Create id targets using the “HTML Anchor” field

If you use headings in your content, you can use the “HTML Anchor” attribute of blocks to set a target id. Select your block, click “Advanced” in the right panel and insert the target id you want in the “HTML Anchor” field.

Create id targets using “Additional CSS Class(es)” field

You can generate id targets for any block element, by setting its class name to: ps2id-id-yourid, changing the yourid part to the id value you want.

Click on a block element (e.g. a paragraph), click “Advanced” in the right panel and set the target id you want in the “Additional CSS Class” in the form of:
ps2id-id- plus the id you want.
For example, if you want to create the target id “last-section”, give the element the CSS class:

Create id targets using plugin’s “Page scroll to id target” block

The plugin has its own custom block for inserting targets: “Page scroll to id target”

Creating id targets in post visual editor (classic “old” editor)

tinymce-custom-btn-ps2id-target In post visual editor, click the toolbar button “Insert Page scroll to id target” to create a target at the cursor position in the editor.

page-scroll-to-id-target-modal In “Page scroll to id target” modal insert the id value you want (e.g. some-id) and click “OK”. The target shortcode (e.g. [ps2id id='some-id' target=''/]) will appear in the editor. Update/save the post/page. You can now use this id value in your link(s) URL (e.g. #some-id).

Creating id targets in post editor via shortcodes

In post visual or text editor, enter [ps2id id='some-id'/] in the place you want to create the target and set the id attribute to the value you want. This will create a simple anchor-point target. If you want to wrap your content (or part of your content) in a target id (same as adding an id attribute to some content), use the [ps2id_wrap] shortcode:

[ps2id_wrap id='some-id']
your content...

Update/save the post/page so you can use this target value in your link(s) URL (e.g. #some-id).

Click here for more info on target shortcodes

Creating id targets in HTML

Wrap your content in a div with an id attribute (recommended for better link highlighting) or add simple anchor points (with id attributes) before each content section. Examples:

<div id="section-1">
  <p>Section 1 content...</p>

<div id="section-2">
  <p>Section 2 content...</p>

<div id="section-3">
  <p>Section 3 content...</p>
<a id="section-1"></a>
<p>Section 1 content...</p>

<a id="section-2"></a>
<p>Section 2 content...</p>

<a id="section-3"></a>
<p>Section 3 content...</p>

Creating id targets in WordPress widget areas

Create targets in your widget areas (Appearance → Widgets) via plugin’s “Page scroll to id target” widget.
Keep in mind that all WordPress widgets have existing id values that you can use with your links. You can find these id values within each active widget under “Page scroll to id target” label. The option to display these values is “Display widgets id attribute” which is enabled by default.


Creating links

page-scroll-to-id-target-menu The plugin is enabled by default on WordPress Menu links (Appearance → Menus), so you can start adding custom links and set their URL to the id/target you want to scroll to.

Edit your menu and add “Custom links” as these type of links allow us to enter a custom URL with the id we want. Your links URL should be in the form of #some-id,, /page/#some-id etc.

Please note that if you want your links to work from other/different pages, you’ll need to insert the full address with the target id in their URL (e.g. or the relative-root URL (e.g. /page/#some-id).

You can use plugin’s shortcodes in the block editor. Add the shortcode: [ps2id url='#some-id']link text[/ps2id] inside any block element to create a link that points to the “some-id” target.

Keep in mind that since “Page scroll to id” version 1.6.3, the plugin is enabled by default on all links with a non-empty hash value (e.g. #some-id) in their URL. This means that you don’t have to use plugin’s shortcode to create links, as any link you create via the WordPress editor will work.

tinymce-custom-btn-ps2id-link In post visual editor, click the toolbar button “Insert/edit Page scroll to id link” to create a link at the cursor position in the editor or from text you’ve already selected.

page-scroll-to-id-link-modal In “Page scroll to id link” modal insert the link’s URL and text. The URL should be in the form of #some-id,, /page/#some-id etc. When ready, click “OK” and the link will appear in the editor. You can edit the link via both “Insert/edit link” and “Insert/edit Page scroll to id link” buttons, as well as inline.

“Page scroll to id link” modal provides additional options like “Offset” and “Custom class(es)” that can be used to change link’s offset, its scroll duration/speed etc.

In post visual or text editor, enter [ps2id url='#some-id']link text[/ps2id] in the place you want to create the link and set the url attribute and link’s text to the values you want. The shortcode provides the same options as plugin’s “Insert/edit Page scroll to id link” toolbar button via attributes.

Any link with ps2id class or m_PageScroll2id rel attribute value will be handled by the plugin. For example:

<a href="#some-id" class="ps2id">link text</a>
<a href="#another-id" rel="m_PageScroll2id">link text</a>

You can instruct “Page scroll to id” to handle any link in your page(s) by using the “Selector(s)” field in plugin settings.
If you need to enable “Page scroll to id” on all links with URL containing a hash (#), insert the following value in “Selector(s)” field:

Click here for more info on “Selector(s)”


Links highlighting

Each time a target element is visible on the screen (i.e. is within the viewport), the plugin adds the mPS2id-highlight class to its associated link or links (i.e. the links that scroll to this target). You can use this class in your theme’s stylesheet or custom CSS to style the current/active link(s), e.g.
a.mPS2id-highlight{ background: #ff0; }

Common case scenario and example

Lets say you have a sticky menu containing links that scroll to various targets/sections within the page. Your links text color is black (which may be set by your theme or some other stylesheet):

.memu-item a{ 
    color: black; 

When scrolling through page sections (i.e. targets) you want the link of the visible/current target to become red. You can do this by adding the following CSS:

.memu-item a.mPS2id-highlight{ 
    color: red; 

Notes and more info

The default highlight classes for the links are: mPS2id-highlight, mPS2id-highlight-first and mPS2id-highlight-last (you can change these class-names in plugin’s settings if you want).

For more information about the highlight classes and options see “Classes & highlight options”, “Highlight selector(s)” and FAQ below.


Offset scrolling for sticky menus

If your page has a top sticky/fixed-positioned menu, you’ll probably need to use plugin’s “Offset” option in order to prevent the menu from overlapping your content. This option allows us to shift (i.e. offset) scrolling, so in the case of a top sticky menu, we usually need to “stop” scrolling a few pixels before the target reaches the top of the page (to accommodate for the space the sticky menu occupies).

Go to Settings → Page scroll to id → Offset and insert an offset amount equal to your sticky menu height (in pixels). You can insert its height value as a number (e.g. 100) or you can insert your menu selector (e.g. #my-sticky-menu), so the plugin calculates its height automatically.

The plugin provides special selector expressions in order to define advanced offsets and work with responsive menus. For more info see “Offset” option.

Scrolling from/to different pages

The plugin has the option to scroll from/to different pages enabled by default. This means that when you click a link which points to a target id on another page, you’ll still get the smooth scrolling effect which will happen immediately after that page is fully loaded.

The only thing you’ll need is to make sure your links have the full address with the target id in their URL (e.g.

Video tutorial


Post a comment

Comments pages: 1 7 8 9

  1. Anuj
    Posted on May 31, 2021 at 06:05 Permalink


    On one page I want to use a ‘menu’ created using divi blurb module that sticks to the top. When the use clicks on one of the blubs the page scrolls to the relevant section. Currently all the blurbs are highlighted at once.
    Is it possible to style/highlight a single blurb at a time using this plugin?

    Help will be greatly appreciated.


    • malihu
      Posted on May 31, 2021 at 13:41 Permalink


      Yes, the plugin provides a way to highlight only a single menu item. You can see the “Links highlighting” section above and this FAQ.

      This said, I’m not sure if the highlighting you see comes from your theme or somewhere else. Did you use plugin’s .mPS2id-highlight class in your CSS? If not, then the highlight styling you see comes from your theme.

      If I could see your site/page, I’d be able to see what happens and provide more help.

  2. Fabian Pena
    Posted on May 26, 2021 at 20:11 Permalink

    Hello, I have installed this plug and i followed the instructions with WPBakery and it doesn’t work, then I watched the tutorial video and it didn’t work either.

    What could it be?
    Thank you

    • malihu
      Posted on May 26, 2021 at 23:49 Permalink


      I just checked your site and it seems to be working now. Did you fix it or?

  3. Raybblinh
    Posted on May 10, 2021 at 16:50 Permalink

    Hi Malihu,

    I love the plugin and how it works, but there seems to be a grey overlay over the impacted links.

    I have tried various filters to improve brightness and contrast but it did not work.

    How can I remove it so that my links are a true white?

    Thank you!
    Raybblin 🙂

    • malihu
      Posted on May 10, 2021 at 22:26 Permalink


      There’s an opacity rule (0.5) applied on the parent h3 tag of each link. You can do something like this:

      h3{ /* remove opacity */ opacity: 1; } h3 > span, h3 > span > a{ /* make links color white */ color: #fff !important; }

  4. Mira
    Posted on April 7, 2021 at 10:54 Permalink

    Hi malihu,

    I am new to WordPress and installed your plugin. I have a problem with highlighting the links in my main navigation menu when scrolling. My preferred option is: hover + highlighting: color white, background black – the only button that works is the Home button

    I use this css: .menu-item a.mPS2id-highlight {color: white!important;}
    .menu-item a.mPS2id-highlight {background: black!important;}

    and it all worked fine until yesterday. I am still working on the website (it’s not meant to be published yet) and maybe I changed something by accident, but I can’t figure out what is wrong. The Advanced Option “Prevent other scripts from handling plugin’s links (if possible)” is activated. I would be really greatful if you could help me, it’s my first website and I’m a bit lost….
    Many thanks

    • malihu
      Posted on April 7, 2021 at 15:34 Permalink

      Hello Mira,

      I need to see the page/content in order to help. If you want to send me any passwords etc. you can contact me via email 🙂

  5. Matthew
    Posted on March 12, 2021 at 21:21 Permalink

    Hi Manos!

    I am using plugin ‘Options for Twenty Seventeen’. If I go into Appearance, Customise, Theme Options, then check the box for ‘Back to Top Link’ then a grey strip appears along the bottom of the page! If I inspect the element it says ‘. I will email you the URL 🙂 Thank you!


  6. megha
    Posted on February 10, 2021 at 09:40 Permalink

    i used this plugin in my elementor website, it scrolls to ID perfectly but i am not able to highlight my current activated section.

    • malihu
      Posted on February 10, 2021 at 14:25 Permalink

      I need to see your site/page in order to help. Can you post your URL?

      • Megha Patel
        Posted on February 11, 2021 at 10:41 Permalink

        Your Plugin is amazing. it is a blessing for us who doesn’t know much about javascript and CSS.

        My Site url is “”

        I can Scroll to page with this plugin. But activate section is not highlighted .

        i used this css

        .elementor-nav-menu ul.mPS2id-highlight{
        color: red;

        Thank you so much for your attention.
        it means alot.

        • malihu
          Posted on February 11, 2021 at 15:25 Permalink

          In plugin settings, remove the #about value from “Highlight selector(s)” option and set it to:

          .elementor-nav-menu .menu-item a

          Also, disable “Allow only one highlighted element at a time” option.

          Click save changes.

          Change your CSS to:

          .elementor-nav-menu .menu-item.current-menu-item .elementor-item a.mPS2id-highlight{ color: red; }

          Test and let me know

  7. muq
    Posted on December 1, 2020 at 14:01 Permalink


    I’ve another quick question, Can we use both vertical and horizontal scrolling at a time on the same page?

    Looking forward to your response.


    • malihu
      Posted on December 1, 2020 at 22:07 Permalink

      Yes, by using the “auto” value in “Page layout” option in plugin settings.

  8. muq
    Posted on December 1, 2020 at 12:57 Permalink


    Hope you are doing great!

    I would like to use your plugin to swipe the slider from left to right and up to down by finger touch on mobile.

    Like as when clicking over the section buttons, it jumps to the exact next slide but while we swipe with a finger on mobile. it doesn’t jump over the next slide.

    Could you please confirm to me if this feature is part of your plugin? I’m checking with the demo.

    Your prompt reply would be highly appreciated.


  9. Norman
    Posted on November 10, 2020 at 17:07 Permalink

    Great plugin!
    I’m using this to highlight the menu items in a sidebar, So as the user scrolls to the id the highlight shows in the sidebar.

    My sidebar has multiple levels:




    At the moment the highlight only works on the parent. Would you be able to tell me if it’s possible to highlight the child and subchild too and if so how please?


    • malihu
      Posted on November 12, 2020 at 00:14 Permalink

      If your child/subchild links point to a child/subchild section, they will get highlighted. Are your child/subchild items links that point to child/subchild targets?

      • norman
        Posted on December 4, 2020 at 16:06 Permalink

        Yes they are, This is why i am confused with you it’s not highlighting

        • malihu
          Posted on December 4, 2020 at 21:01 Permalink

          I’d need to see your site/page in order to help. Can you post your URL?

          • Norman
            Posted on December 7, 2020 at 11:12 Permalink

            I have actually got it working now, Thank you!
            I ask if there’s a way to have 2 highlight classes? One I can assign to the child and one to the subchild?

            I ask this because I have selected ‘Allow only one highlighted element at a time’ as sometimes 3 subchildren will highlight if they’re in view, However having this ticked then means my child wont be highlighted too.

            There are times when I need the child to be highlighted as well as the subchild but I only want 1 subchild to highlight not the 3 in view.

        • malihu
          Posted on December 7, 2020 at 22:51 Permalink

          The plugin does not provide 2 highlight classes but you might be able to do it using the .mPS2id-highlight-first and .mPS2id-highlight-last classes (you’ll need to disable “Allow only one highlighted element at a time” option to see these classes applied) in combination with .mPS2id-highlight class.

          The thing is that I can’t provide any CSS rules without seeing your page/site in action.

          Let me know if you can post or maybe send me your URL.

  10. [email protected]
    Posted on September 24, 2020 at 03:05 Permalink


    I’m using a sticky bar for navigational purposes and I was wondering if instead of the section being highlighted, could the letters appear in bold instead?


  11. Mariana Mugeiro
    Posted on September 23, 2020 at 18:37 Permalink

    Hello! Love the plugin, but I’m having some issues with the highlighting of the links.

    I have a one-page nav menu (WordPress menu) with anchors to different sections on one page and all of the menu items appear to be highlighted at all times when I’m on that page!

    I’ve tried enabling the “Allow only one highlighted element at a time “and the “Keep the current element highlighted until the next one comes into view (i.e. always keep at least one element highlighted)” options but it doesn’t seem to work. All my “Home” menu items are highlighted when I’m at the home page, all my “Results” items are highlighted when I’m in the results page.

    Can you please help me? Thanks!

    • malihu
      Posted on September 24, 2020 at 04:01 Permalink


      The highlight you see is done by your theme (not the plugin). It’s common for themes to highlight same-page menu items, so that’s what happens here.

      To revert this and use plugins highlighting, use the following CSS:

      header .navbar ul li .sub-menu li.current-menu-item a._mPS2id-h:not(.mPS2id-highlight):not(:hover){ background-color: inherit !important; color: inherit; }

      Let me know if it worked

      • Mariana Mugeiro
        Posted on September 28, 2020 at 11:37 Permalink

        Yes, it worked! Thank you so much 🙂

  12. Alex
    Posted on August 8, 2020 at 08:51 Permalink

    I’ve been using this wonderful plugin for months, but now I have had this problem for a few weeks: when I click on a link, scrolling behaves like this:

    1. it begins to flow smoothly
    2. the scrolling freezes for a few moments before reaching the target (where it stops depends on how far the target is within the page: the target is distant within the page, the more this effect is visible)
    3. then it finally reaches the target

    I don’t know if I managed to explain myself, but using the site it is very visible.

    What could be the reason?

    Thanks for the support!

    • malihu
      Posted on August 8, 2020 at 12:51 Permalink


      The reason for the issues you’re having is because of lower performance when the links in your page get highlighted.

      It seems that there are over 150 links that get highlighted in the page. You need to set which ones you actually want to get highlighted by the plugin.

      Go to plugin settings and set the “Highlight selector(s)” value to:

      #menu-lato a

      Click save changes and test your page.

      In addition, another script is highlighting your aside menu links (blue border and dark text). I can’t really say which one is it as it’s inside your wp-content/uploads/siteground-optimizer-assets directory but it seems to also have a performance impact on the page.

      If you only use this script (with the class .accendi) to highlight you links, you could disable “Page scroll to id” highlight feature (since you’re not using it) by setting “Highlight selector(s)” option value to:


      Hope this helps

  13. Shahzad
    Posted on June 18, 2020 at 06:07 Permalink

    I am using the plugin in a template. ID’s are same for all the targets but for url, ofcourse it will be changed for every page using that template. How to deal with this please?

    • malihu
      Posted on June 18, 2020 at 15:43 Permalink


      I’m not sure I understand the issue but you can use any type of URL in your links.

      If for example your targets are the same on every page, you can have links in the form of #buy, #rent etc.

      If your targets are on a specific page, you can have links with absolute URL like, etc. or relative-absolute URL like /#homepage-section, /some-page/#some-page-section etc.

      Hope this helps

  14. Rajesh d
    Posted on June 1, 2020 at 22:12 Permalink


    Help me please!

    my website is, i used page scroll to id plugins it works on desktop version but when i check on mobile screen i was unable to scroll website till footer. Its stuck and bouncing.

    • malihu
      Posted on June 2, 2020 at 07:03 Permalink


      I don’t think the plugin has something to do with this issue. What happens when you temporarily deactivate “Page scroll to id”? Can you scroll to the footer?

    • malihu
      Posted on June 2, 2020 at 07:05 Permalink

      You also have another script in your theme that produces a js console error when scrolling the page. Maybe this is causing the issue(?)

      The theme script is:



Comments pages: 1 7 8 9

Post a comment

Cancel reply

Your e-mail is never published nor shared. Required fields are marked *

You may use these HTML tags and attributes:
<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>
You can write or copy/paste code directly in your comment using the <code> tag:
<code>code here...</code>
You may also use the data-lang attribute to determine the code language like so:
<code data-lang-html>, <code data-lang-css>, <code data-lang-js> and <code data-lang-php>