Ultimate Post List


Make up custom-tailored preview lists of your website’s contents easily and place them in widget areas and post contents.

Promote your website’s content with many kinds of post lists. No programming skills are necessary. No fiddling with templates. With just a few keyboard entries and clicks you get a customized posts list.

The plugin Ultimate Post List for WordPress gives you an easy-to-use toolbox to make lists of posts. You can insert the lists

  • as widgets in every widget area per drag’n’drop easily
  • via configurable shortcodes in every post content
  • via calls of the function upl_print_list() in PHP code

You can switch between a vertical list layout or a responsive grid layout. A few options help you to get a nice layout without any need to code.

You can filter the posts by their post type “Post” or/and “Page” and by multiple categories. For filtering by custom post types check out Ultimate Post List Pro.

You can switch on a “Load more posts” link or button which loads further posts without leaving the page. Its text is controlled easily for you.

The plugin is multi-widget capable. That is, you can have several widgets of Ultimate Post List on your blog, each with its own settings!

You can clone (duplicate, copy) every list with a single click on the action link.

The plugin is available in English, German (Deutsch) and Greek (Ελληνικά). It does not collect any personal data, so it is ready for EU General Data Protection Regulation (GDPR) compliance.


You want to test Ultimate Post List before installing on your site? Try it out on your individual and free dummy site and click here.

Options you can set

The free version of Ultimate Post List offers you many options to type and click customized post lists easily. These are the options:

  • List Options
    • List Display Options
      • List Visibility
      • Text if no posts
    • List Title Options
      • List title
      • URL of list title
      • HTML element of list title
  • Post List Options
    • Post List Options In General
      • Number of posts
      • Posts offset
      • Hide current viewed post in list
      • Show sticky posts on top of the list
    • Posts Sort Order
      • Order by
        • Post date
        • Post title
        • Post author
      • Order direction
        • Ascending
        • Descending
  • Post Filter Options
    • Post Type Filter
      • Show posts of selected types: posts or/and pages
    • Category Filter
      • Show posts of selected categories only
      • Show only posts that are in all selected categories
  • Post List Item Options
    • Post Data Order
      • Position of post thumbnail
      • Position of post title
      • Position of post date
      • Position of post author name
      • Position of post excerpt
    • Post Display Options
      • Show post thumbnail (default)
      • Show post title (default)
      • Show post date
      • Show post author name
      • Show post excerpt
    • Post Links Options
      • Set post title clickable (default)
      • Set post thumbnail clickable (default)
      • Set post date clickable, pointing to the month archive
      • Set post author clickable, pointing to the author’s archive
      • Set post excerpt clickable
      • Open post links in new windows
    • Post Title Options
      • Maximum length of post title
      • Text after shortened title
    • Post Date Options
      • Format of the post date (over 100 options available)
    • Post Thumbnail Options
      • Source of the post thumbnail
        • Featured image
        • First post content image if previously uploaded to the media library
        • Featured image if the first post content image is not available
        • First post content image if the featured image is not available
        • Avatars of post authors
      • Use post title as the alternative text for the thumbnail
      • Use default thumbnail if no image could be ascertained
        • URL of default thumbnail
        • Thumbnail size
      • Width of thumbnail in px
      • Height of thumbnail in px
      • Use aspect ratios of original images
      • Alignment of thumbnail
        • Align left
        • Align center
        • Align right
      • Top image margin width in px
      • Bottom image margin width in px
      • Left image margin width in px
      • Right image margin width in px
      • Flow of text at the thumbnail (wrap right/left or side by side)
    • Post Excerpt Options
      • Maximum length of post excerpt
      • Text after shortened excerpt
      • Ignore post excerpt field as excerpt source
      • Ignore post content as excerpt source
  • “More” Element Options
    • “More” Element Appearance
      • Show a clickable “More” element for loading further list items at the bottom of the list
      • “More” element type
        • Show element as a link
        • Show element as a button
      • Label of “More” element
      • Show icon while new posts are loaded
      • Icon style
        • Small icons
          • Small gray circle with rotating dot
          • Small turning wheel
        • Big icons
          • Big gray circle with rotating dot
          • Big turning wheel
      • Text that appears when no further posts have been found
  • List Layout Options
    • List Layout Type: vertical list or responsive grid
    • Grid item width in px
    • Minimal height of grid item in px
    • List Item Margin Options
      • Top item margin in px
      • Bottom item margin in px
      • Left item margin in px
      • Right item margin in px

Additional options in the Pro version

The Pro version has all the options of the free version and many additional options for layouts, numbered lists, colors, custom post types and much more. Go to Ultimate Post List Pro.

Pro users get premium support whilst free support is offered in the WordPress forums in our spare time.


Support for this plugin will be provided in the form of Product Support. This means that we intend to fix any confirmed bugs, listen to ideas for this plugin and improve the user experience when enhancements are identified and can reasonably be accommodated.

Pro users get premium support whilst free support is offered in the WordPress forums in our spare time. If you are having trouble with this plugin in your particular installation of WordPress, we will not be able to help you troubleshoot the problem.


  • The edit page of an Ultimate Post List in english language
  • The widget form of an Ultimate Post List in english language
  • Examples of Ultimate Post Lists on one page: lists as content and as widgets
  • Example of an Ultimate Post List widget with avatars of the post authors as thumbnails


Using The WordPress Dashboard

  1. Navigate to the ‘Add New’ in the plugins dashboard
  2. Search for ‘Ultimate Post List’
  3. Click ‘Install Now’
  4. Activate the plugin on the Plugin dashboard
  5. Go to ‘Ultimate Post List’

Uploading in WordPress Dashboard

  1. Navigate to the ‘Add New’ in the plugins dashboard
  2. Navigate to the ‘Upload’ area
  3. Select ultimate-post-list.zip
    from your computer
  4. Click ‘Install Now’
  5. Activate the plugin in the Plugin dashboard
  6. Go to ‘Ultimate Post List’

Using FTP

  1. Download ultimate-post-list.zip
  2. Extract the ultimate-post-list
    directory to your computer
  3. Upload the ultimate-post-list
    directory to the /wp-content/plugins/
  4. Activate the plugin in the Plugin dashboard
  5. Go to ‘Ultimate Post List’

அடிக்கடி கேட்கப்படும் கேள்விகள்

Useful hints for developers

Every Ultimate Post List offers you some IDs and class names to address the HTML elements with CSS. They are:


is every Ultimate Post List.


is the list with %d as the list ID set by WordPress


is every list item that contains a sticky post.


is every container of a post thumbnail in the list.

div.upl-post-thumbnail img

is every post thumbnail in the list.


is every post title in the list.


is every post date in the list.


is every post author in the list.


is every post excerpt in the list.


is the “more” element with %d as the list ID set by WordPress.


is every “more” element, as a link or as a button in the list.


is the “more” link with %d as the list ID set by WordPress.


is the “more” button with %d as the list ID set by WordPress.


is the spinning wheel image with %d as the list ID set by WordPress.

Shortcode Attributes

To place a Ultimate Post List in the content of a post or page a shortcode is available. The shortcode keyword for this plugin is ultimate-post-list.

The attribute id with the ID of a published list is required. Otherwise there is no output.
Example: This shortcode prints the list of ID 48 as set on the List Edit page.
[ultimate-post-list id=”48″]

You can add some attributes to overwrite the respective settings of the list.

Sets the headline of the list. To remove a headline use an empty string.
Example: list_title="Your Site, Your Way"
Example: list_title=""

Displays only posts of the categories specified by their IDs, slugs or names, separated by commas.
Example: included_categories="323,245,788"
Example: included_categories="lorem-ipsum,fringilla-mauris,dolor-sit-amet"
Example: included_categories="Lorem ipsum,Fringilla mauris,Dolor sit amet"

You can use specifiers of different types in a comma-separated list.
Example: included_categories="Lorem ipsum,245,dolor-sit-amet"

Example: [ultimate-post-list id="48" list_title="Your Site, Your Way" included_categories="News"]


ஏப்ரல் 27, 2021 1 reply
Ultimate post list has made it so much easier to display posts. It was easy to set up and works well. I ran into a problem from a recent update and was given immediate and effective support. Thanks Ultimate Post List!
டிசம்பர் 8, 2020
I was impressed with the stated capabilities of the plugin and more impressed with the reviews of the support received by other users. I was already committed to using the PODS plugin to define my CPT tables, but was having troubles making the UPL Pro plugin work with it. Martin responded to my support request quickly, however we amicably concluded that the two plugins were incompatible at this time. Martin’s service was prompt and professional.
நவம்பர் 4, 2020 1 reply
Just wanted to say thanks for keeping your plugin updated. The free version of the Ultimate Post List works great. I had an issue with my WordPress theme’s latest Update because the “More” button stopped working, so I emailed Martin. Martin within a day or two fixed the issue! It’s a great simple post list plugin! Thank you for keeping up with the updates!
பிப்ரவரி 20, 2020
After I bought the premium version, the author helped me with my problem with some custom CSS. I truly appreciated that. This is VERY important and I only discovered this after hours of frustration – in order to see my changes, I had to *individually* delete my cookies. Simply CtrlF5 didn’t work for me. I have tested on Firefox, Chrome, and Opera. Obviously I tried deleting cache on the website level. It may be a conflict with my cloud and my WT3 Total cache settings. I never had to do this with on other plugins, though.
ஜூன் 6, 2019
This is really well done and has all the right options… Thank you so much!
அக்டோபர் 25, 2018 1 reply
Hello, I want to display only the selected categories posts, how to do that? Thanks in advance Roman
Read all 13 reviews

பங்களிப்பாளர்கள் & உருவாக்குனர்கள்

“Ultimate Post List” is open source software. The following people have contributed to this plugin.


“Ultimate Post List” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “Ultimate Post List” into your language.

Interested in development?

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


  • fixed debugging information were shown


  • fixed pages won’t be listed (thanks to @brvnbld; https://wordpress.org/support/topic/pages-not-showing-in-the-list/)


  • fixed error on loading help page
  • fixed not loading JS files anymore
  • added minified JS files to improve loading time
  • added compatibility with WordPress 5.8
  • tested successfully with WordPress 6.0


  • fixed widget was not showing in admin area


  • const names standardized
  • added autoload class
  • tested successfully with WordPress 5.7.1


  • new branding
  • Tested successfully with WordPress 5.6.2
  • Tested successfully with WordPress 5.7


  • Revised link text for posts with no title
  • Tested successfully with WordPress 5.6


  • Fixed broken ‘more’ link if the theme supports ‘navigation-widgets’
  • Changed order of action links
  • Corrected outdated translation
  • Tested successfully with WordPress 5.5.3


  • Added NAV element around the post list if the theme supports the ‘navigation-widgets’ type (introduced in WP 5.5)
  • Added aria-label to the NAV element for better accessibility
  • Added loading=”lazy” attribute to the default image (introduced in WP 5.5)
  • Revised translations for WP 5.5
  • Fixed wrong sanitazion of checkbox groups
  • Updated translations
  • Tested successfully with WordPress 5.5


  • Refined the description about first post content images
  • Refactored rendering of HTML element attributes
  • Updated translations


  • Revised options rendering to enable HTML element attributes
  • Tested successfully with WordPress 5.4


  • Added option for using the post title as the alternative text for the thumbnail
  • Added line breaks before descriptions on the list edit page
  • Added fieldset margins in admin.css
  • Refactored Javascript in public JS file
  • Updated translations
  • Updated screenshot of Edit Page


  • Refactored for huge performance improvements
  • Revised Help page
  • Updated translations
  • Tested successfully with WordPress 5.2.2


  • Added link to Help page under the shortcode box on a list edit page
  • Moved text-thumbnail-wrap option to thumbnail options
  • Fixed wrong screenshot of the shortcode box
  • Updated translations
  • Updated screenshot of Edit Page
  • New in the Pro version: Support of shortcodes in post excerpts


  • Added option to use only except fields as the source for excerpts
  • Updated translations
  • Updated screenshot of Edit Page


  • Added copy button at the shortcode field on the list edit page
  • Fixed wrong list title if the list is in the post content
  • Updated translations
  • Updated screenshot of Edit Page


  • Added options for excerpts
  • Fixed wrong checkbox default values
  • Fixed erroneous breaks in narrow lists
  • Introduced in Pro version: Numbered lists
  • Updated translations
  • Updated screenshot of Edit Page


  • Fixed missing output of the list


  • Added post type filter
  • Added category filter
  • Revised columns adding function for the lists overview page in the backend
  • Updated translations
  • Updated screenshot of Edit Page


  • Fixed missing list title in the output


  • Revised image size selection if a registered image size name is used
  • Revised paths to public CSS file
  • Changed wp_get_attachment_image_src() to wp_attachment_is_image()
  • Tested successfully with WordPress 5.0.3


  • Added option to display the text next to the thumbnail instead of floating around it
  • Added new function upl_print_list() to call a list in PHP code
  • Updated translations
  • Tested successfully with WordPress 4.9.4


  • Added greek translation. Thank you, Kostas Arvanitidis!
  • Updated translations due to WordPress 4.9
  • Tested successfully with WordPress 4.9.1


  • Fixed missing initialization of UPLP options in the frontend


  • Fixed missing detection of custom post types for the list edit page
  • Added ‘Requires PHP’ info in readme.txt


  • Added “Load more posts” feature (display further posts without page reload)
  • Added options for “Load more” button
  • Fixed undesired subpage in UPL admin menu if plugin “WordPress Editorial Calendar” is active
  • Updated translations


  • Fixed static width of list items if item width is greater than viewport width
  • Tested successfully with WordPress 4.8.1


  • Revised sanitations for texts and URLs on the pages
  • Revised translations
  • Set activation message as dismissible
  • Tested successfully with WordPress 4.8


  • Added list title option; important: Please add the list title in this option if it was shown in post content
  • Reordered menu items in navigation; list of lists is main page now
  • Revised Help page
  • Revised message on plugin activation
  • Updated translations


  • Added on lists table: sortable “Last Modified” column
  • Improved on lists table: “Author” column made sortable


  • Improved performance in getting avatars


  • Added avatars as new source of thumbnails
  • Tested successfully with WordPress 4.7.3


  • Removed 3rd-party metaboxes from list edit page
  • Fixed unnecessary loading of CSS and JS on all pages except list edit page
  • Tested successfully with WordPress 4.7.2


  • Removed sanitation of post title


  • Added check for loading javascript and CSS only on list edit page
  • Revised widget template for more conformity to WP standard widget output
  • Tested successfully with WordPress 4.7.1


  • Added new labels to the ‘Ultimate Post List’ post type, introduced with WordPress 4.7
  • Tested successfully with WordPress 4.7
  • Updated translations


  • Added action link ‘Copy’ to duplicate lists
  • Added CSS width limit for selection field in widget control form
  • Improved sanitation in admin page: Added check for empty input or no-array input
  • Updated translations


  • Added option for post date format
  • Updated translation


  • Added options for grid layout
  • Updated translation
  • Tested successfully with WordPress 4.6.1


  • Revised uninstall function for WordPress 4.6 due to the introduction of WP_Site_Query class
  • Fixed translation for WP 4.6
  • Tested successfully with WordPress 4.6


  • Fixed: the list always appeared first before other content
  • Tested successfully with WordPress 4.5.3


  • Fixed missing descriptions at checkboxes on the options page
  • Fixed: outdated translations for post statusses
  • Tested successfully with WordPress 4.5.2


  • Shortened readme.txt


  • Initial release