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:

View this gist on GitHub

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