Links Shortcode

Support for this plugin has been moved. For more information about this plugin, please visit the support page on my company website,

If you have comments, questions or feedback about this plugin, please use the forum on

25 Responses

  1. Marcel says:


    Thanks for a great plugin. Would be nice if you could imclude the link image as an option in the Links shortcode plugin.

  2. Maarten says:

    Hi Marcel,
    Sounds like a good idea! How would you like to show the images: which size, next to, above, beneath the link, between link and description? Or should this all be options?

  3. tug says:

    hey maarten,

    love your “links short code” plug-in. it was exactly what i needed to pull a link category into a page on my website.

    i would like to make a donation to it. could you provide me with your paypal email address so i can send in the donation?


  4. Mike says:

    Hi Maarten

    Links shortcode looks to be ideal for me, but although I can see what it produces in preview mode, it doesn’t show up in the published page. Have you any idea why this might be the case?


  5. Maarten says:

    Mike, I never heard this issue before. One thing I can think of is that links need to be marked as “visible”. On the specific Link page this option is called “Keep this link private” (it should be unchecked). Let me know if this solves your problem.

  6. Mike says:

    Maarten, I already thought of that one and it wasn’t it.
    What I did find out was that it worked on a Page, but not on a Post, but I don’t see any other comments from users with the same problem, so I may not have found the root cause. One thing I did do which did not solve the problem was to disable all other plug-ins.
    Not sure if this helps or hinders, but thanks nonetheless for a really useful plugin.

  7. Maarten says:

    Hello Mike,
    Just brainstorming here. Does your blog theme use exerpts (the small summary of a post) for displaying posts on the homepage?
    It turns out that shortcodes are disabled by default in excerpts.
    If you want to enable shortcodes in excerpts, add the following two lines to the functions.php file of the theme:
    add_filter( 'the_excerpt', 'shortcode_unautop');
    add_filter( 'the_excerpt', 'do_shortcode');

    I found this on
    I hope this helps. If so, don’t forget to vote for my plugin 🙂

  8. Leroy says:

    Thanks for your links shortcode plugin – just what I needed!

    One question though: I don’t know how to code at all and I was wondering if there was something I could add into the sample code you provide that would display an image associated with the link?

    Thanks again!

  9. Maarten says:

    Hello Leroy,

    You could add images in a column next to the description by using the following:
    <tr style="width:100%;">
    <td style="width:100px;vertical-align:top">
    [optional <a href="[link_url]" target=_blank><img src="[link_image]" border=0 style="width:100px"></a>||]
    <div class="links_sc_fb" style="text-align:left">
    [optional [date]: ||]<a href="[link_url]" target="_blank">[link_name]</a>
    [optional <br />[link_description]||]
    [optional <br />[fb_button]||]

    You will need to add the following as code to be inserted before the links:
    <table style="margin:0;padding:0;">
    And the following to be inserted after the links:
    I hope this helps.


  10. tug says:

    hi maarten,

    my category links stopped working ever since I upgraded to the latest version of wordpress.

    this page is supposed to show one of my link categories, but for some reason it is no longer working.

    any ideas?

  11. Maarten says:

    Hi tug,
    I’m not sure what happened. The latest WordPress update does not contain any changes to the links logic, as far as I know. On my side the plugin still works to show links in a certain category (see for an example). Some questions to further diagnose:

    1. What is the exact shortcode format you are trying to use?
    2. Could you verify that the Shortcode template in the settings page is not empty (this should not happen, but check it just in case)
    3. Are you using the category slug or name? you should use the name in the shortcode.
    4. Has something else happened causing the category to be renamed or become empty?
  12. Luke says:

    Tug and Maarten :

    I had same problem after updating to 3.3.1 on a site. And Maarten you suggestion

    “Could you verify that the Shortcode template in the settings page is not empty (this should not happen, but check it just in case) ”

    was correct it was empty.

  13. Susan L says:

    Having trouble with your plugin today. When logged out, the links are not updated to the current links. It is displaying some links that have been deleted and not showing the current links in the category (3/23 links). When I am logged in, the correct links are showing.

  14. Susan L says:

    Sorry – here is my url:

  15. Maarten says:

    Hi Susan,
    As we determined per email, this issue is caused by a caching plugin, where the cached pages still show the links that were deleted.
    Thank you for your contribution!

  16. Tony says:

    installed and activated your plugin.
    disabled Facebook options, I hate social media.
    create test page with shortcode for just one category.
    nothing displayed.
    there is no template info on the settings page. I assume this means the default template is not loaded.
    Where can I get a default template?
    What is the default template?

    Thanks for the plugin. Wish I could get it working.

  17. Maarten Swemmer says:


    This should clearly not happen. When you first install the plugin, it should setup the default template. It is also displayed for your reference on the Examples section of the Settings page, but here it is again:
    <div class="links_sc_fb">
    [optional [date]: ||]<a href="[link_url]" target="_blank" rel="nofollow">[link_name]</a>
    [optional <br />[link_description]||]
    [optional <br />[fb_button]||]</div>

    For you, not wanting to display the facebook button:

    Next you will be able to show the links using this shortcode in your post (replace Blogroll by the name of your category):[links category_name="Blogroll"]

  18. HR Hegnauer says:


    Great plugin! How can I allow the description field to display more characters? It truncated the description at 255 characters.

    Thank you!


  19. Maarten Swemmer says:

    Hi HR, The description is indeed limited to 255 characters. This is the result of how WordPress is implemented. WordPress itself does not store more than 255 characters for the description. Alternatively you can use the Notes field which is available in the plugin as [link_notes].

  20. Mia says:

    Hope you can help me with this one! I have installed your plugin to my site which is great!!! However, I would like for the entire background to be transparent to be in line with the rest of my pages/posts etc. Can you help with this please?



  21. Maarten Swemmer says:

    Hi Mia, the background color is not defined by the shortcode. It is defined on line 5 of your dark-style.css stylesheet and line 99 of style.css for the <pre> element, in which you have embedded the shortcode. By removing those background statements from the CSS or removing the <pre> and </pre> from your page, you can make the background transparent.

    If this is helpful a small Paypal contribution to my work is highly appreciated.

  22. Margaret Hitchcock says:

    Hi Maarten, thank you so much for this great plugin. Can you please advise me how can I make the links show by link ID in a descending order?

    Thanks a bunch!

  23. Maarten Swemmer says:

    Hi Margaret, you could try [links orderby="link_id" order="DESC"]. It’s currently not possible to order by ID by default, as I do not encounter this requirement very often.
    You could also try [links orderby="updated" order="DESC"], which should order them by when links were last updated, after installing the plugin. The date on which links were last updated is only used when this plugin is installed or when you edit links using external programs. So links added or updated before the plugin was added are not affected.

    If this is helpful a small Paypal contribution to my work is highly appreciated.