The Upendo Blog Article List module displays published blog articles on a website page. It is a companion to Blog Manager. Blog Manager stores and manages the articles. Blog Article List chooses which published articles visitors see and how the list looks.
This guide is for Site Admins, Administrators, Upendo Clients, Superusers, and content staff who have website permission to edit this module. A Blog Publisher Role by itself does not grant permission to change this module's page layout or settings.
What visitors see
Visitors see a list of published articles that match the module settings. The list can show the newest, most popular, featured, most-commented, or randomly selected articles.
Draft, archived, future, and deleted articles are not shown as normal public articles. If no published article matches the filters, the list may be empty.
Each article link uses the configured Blog Article Path followed by the article slug. For example, a blog article path of /blog/ and a slug of how-to-start create a link like /blog/how-to-start.
The module uses normal website module permissions for its edit and settings screens.
- Anonymous visitors can view the list when the page is public.
- General content editors can configure the module only when a site owner gives them website Edit permission for the module or page.
- Site Admins, Administrators, and Upendo Clients can usually configure it when their website permissions allow page and module editing.
- Superusers can manage the module through website administration.
Blog Manager publishing permissions and Article List layout permissions are separate. A person may be able to write a blog draft but not change the Article List display.
Open the module editor
- Sign in to the website.
- Open the page that contains the Article List module.
- Use the page or module menu to choose Edit.
- Open the Blog Article List edit screen.
The screen has Content, Display, and Filters tabs. Select Save Article List Settings after making changes.
Content settings
Section Title
This optional heading appears above the article list. Use a short heading such as Latest News or Helpful Articles.
Leave it empty when the page already has a heading. Two headings next to each other can make the page harder to scan.
Section Description
This optional text appears below the section title. Use it to give visitors a short explanation of the articles in the list.
Keep it brief. It should help visitors understand the list, not repeat every article summary.
This optional line appears below the list. It can contain a short note or call to action, such as Read all company news.
Display settings
Filter Mode
Choose how the module selects and orders published articles:
- Most Recent: Shows the newest published articles first.
- Random: Shows a changing selection of articles.
- Most Popular: Shows articles with the most views first.
- Featured: Shows only articles marked as featured in Blog Manager.
- Most Comments: Shows articles with the most approved comments first.
Use Most Recent for a normal news or blog page. Use Featured only when the Blog Manager team marks articles as featured. Use Most Popular or Most Comments when visitor activity is a useful measure.
Random Refresh Interval
This appears when Random is selected:
- Every page load changes the selection often.
- Once a day keeps the page fresh without moving articles constantly.
- Once a month keeps the selection stable for a longer period.
Daily is usually the safest choice for a business website.
Number of items to display
Choose how many articles appear. The module supports from 1 to 25 items and defaults to 4.
The value is saved with the shared module. If the same module instance is reused in more than one place, changing this value can affect every place that uses that instance.
Layout Options
Choose the visual layout that fits the page:
- Bento: A card-based layout with a larger lead article and supporting cards.
- Simple Numbered List: A compact numbered list.
- Simple List: A compact list without numbers.
- Standard Horizontal: A wide row-style layout.
- Standard Vertical: A stacked layout for normal content areas and narrow spaces.
Check the page at desktop and mobile widths after changing the layout. A layout that looks good in a wide content area may not fit a sidebar.
Filter settings
Filters limit which published articles can appear. Leaving a filter empty allows every value in that group.
Categories
Select one or more categories. Only articles in the selected categories can appear.
Select one or more tags. Only articles with the selected tags can appear.
Authors
Select one or more authors. Only articles written by the selected authors can appear.
You can search within the choices in each filter box. If the list becomes empty after filtering, check the selected category, tag, and author values before assuming the module is broken.
Website-level settings
The module's Settings screen includes two important values:
Template Options
This chooses the file-based visual style used by Article List modules across the website. The default template is intentionally simple so the website theme and portal.css can style it.
Changing the template can affect other Article List modules on the same website. Test all important pages after changing it.
Blog Article Path
This chooses the website page that article links use before the article slug. Select or enter the existing page that hosts the Blog Viewer article view.
For example:
- Article path:
/blog/
- Article slug:
welcome
- Resulting link:
/blog/welcome
Use a real page path. Do not include an article slug in this setting. Save the setting and test an article link after changing it.
Common problems
The list is empty
Check that:
- Blog Manager contains published articles.
- The selected filters match existing articles.
- The filter mode is not Featured when no articles are featured.
- The module is on the correct website page.
- The article path and viewer page are configured correctly.
An article link opens the wrong page
Open the module Settings screen and check Blog Article Path. It must point to the page that hosts the Blog Viewer article view. Also check that the article slug is valid and unique in Blog Manager.
The list looks different from another page
The pages may use different module edit settings, layouts, filters, or templates. Compare the settings for both module instances.
A content editor cannot change the list
Add the needed website Edit permission for the correct page or module. Adding the person to a Blog Publisher Role changes Blog Manager access, not website module editing access.
Before you publish the page change
- The list shows the intended published articles.
- The filter mode matches the page purpose.
- Categories, tags, and authors are correct.
- The number of items fits the page.
- The layout works on desktop and mobile.
- Article links open the correct Blog Viewer page.
- Other Article List modules were checked if the template or website-level path changed.