WordPress: Add plugin settings link to Plugins page

When building a plugin that has its own settings page, it’s often handy to create a link to the settings page straight from the Plugins list – this saves users the time it takes to find where exactly your plugin appears in the admin menu. Here is a simple code snippet that creates the settings link for you – all you need to do is tell it where to go:

Simply replace the href attribute with the link to the plugin settings page and rename the function to something slightly more unique (preferably all wrapped in an if(!function_exists()) conditional).

12 responses to “WordPress: Add plugin settings link to Plugins page”

paul

November 21, 2013 at 5:17 pm

Thanks for the useful tip,

Reply
avi

August 15, 2014 at 2:52 pm

Thanks for the nice post.
however i recommend this little change to make Settings as the first link

array_unshift($links, $settings_link);

Reply
Telaga Sari

July 28, 2015 at 10:39 am

Nice tips, save time for me

Reply
Dennis Hall

August 18, 2015 at 8:46 pm

Hi: I really appreciate this post. It will allow me to (optionally) remove one page from the Admin menu, however, when I click the link, I get the “You do not have sufficient permissions to access this page” message. Any idea what would cause this?

Reply
1. R Wickham
  
  March 23, 2018 at 5:49 pm
  
  @Dennis_Hall This happens when you have an invalid url
  
  Reply
New WordPress Plugin Shows Users Where a Plugin’s Settings Link Is Upon Activation – WordPress Tavern

April 19, 2017 at 9:10 pm

[…] to the above, I encourage plugin developers to read this article by Hugh Lashbrooke, that explains how to add a settings link to the plugins listing page. Adding a […]

Reply
Danny Santoro

July 7, 2017 at 9:05 pm

Hugh, I’ve been trying to figure this out forever now and kept putting it on the back burner because I was getting frustrated trying to Frankenstein code in from other plugins. You’re my hero.

Reply
1. Hugh
  
  July 7, 2017 at 9:09 pm
  
  Always nice to be someone’s hero :p
  
  Reply
Sumon

September 13, 2017 at 7:57 pm

Thanks

Reply
Rayan IT

June 13, 2019 at 12:10 am

Thanks. So Good.

Reply
model gorden rumah sakit

October 1, 2019 at 9:40 am

I couldn’t refrain from ϲommenting. Well written!

Reply
tomaseklund

March 17, 2022 at 10:46 pm

I see you are hard coding the “options-general.php?page=plugin_name” part.

I’ve found that menu_page_url( ‘ plugin_name’, false ) works too. Any particular reason you’re not using this function?

I see that your post is rather old, from July 2012, but the function menu_page_url() has been around since WordPress version 3.0.0 which was released in June 2010.

(Not trying to be a smart-ass. I’m genuinely trying to learn best coding practices for WordPress.)

Reply