---
schema_version: "1"
id: 91e638e15a8fccf5969b4925871747bb32058a87a15664d7642e8687dbf61f2e
title: knowledge:articleList
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/salesforce-pages-developers-guide/guides/pages/components/pages-compref-knowledge-articlelist.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/guide/pages-compref-knowledge-articlelist.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 6de671dbadfa35d3cf65b214b1651b24e6ea0fb1d56aa3847fe7bde4c3f1c78d
products:
  - Visualforce Developer Guide
  - Platform Developer Content
---

# knowledge:articleList

A loop on a filtered list of articles. You can use this component up to four times on the same page. Note that you can only specify one criterion for each data category and that only standard fields are accessible, such as:

- ID (string): the ID of the article
- Title (string): the title of the article
- Summary (string): the summary of the article
- urlName (string): the URL name of the article
- articleTypeName (string): the developer name of the article type
- articleTypeLabel (string): the label of the article type
- lastModifiedDate (date): the date of the last modification
- firstPublishedDate (date): the date of the first publication
- lastPublishedDate (date): the date of the last publication

## Example

knowledge:articleList example that displays the ten most viewed articles in the 'phone' category as an HTML list of links. 'phone' is in the 'products' category group.

```visualforce
<apex:outputPanel layout="block">
    <ul>
        <knowledge:articleList articleVar="article"
            categories="products:phone"
            sortBy="mostViewed"
            pageSize="10"
        >
            <li><a href="{!URLFOR($Action.KnowledgeArticle.View, article.id)}">{!article.title}</a></li>
        </knowledge:articleList>
    </ul>
</apex:outputPanel>
```

## Attributes

| Attribute Name     | Attribute Type | Description                                                                                                                                                             | Required? | API Version | Access |
| ------------------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | ------ |
| `articleTypes`     | String         | The article list can be filtered by article types.                                                                                                                      |           | 43.0        |        |
| `articleVar`       | String         | The name of the variable that can be used to represent the article object in the body of the articleList component.                                                     | Yes       | 43.0        |        |
| `categories`       | String         | The article list can be filtered by data categories.                                                                                                                    |           | 43.0        |        |
| `hasMoreVar`       | String         | The boolean variable name indicating whether the list contains more articles.                                                                                           |           | 43.0        |        |
| `id`               | String         | An identifier that allows the component to be referenced by other components in the page.                                                                               |           | 14.0        | global |
| `isQueryGenerated` | Boolean        | Flag indicating whether this article list was produced from a generated query that did not originate from the user.                                                     |           | 43.0        |        |
| `keyword`          | String         | The search keyword if the search is not null. When the keyword attribute is specified, the results are sorted by keyword relevance and the sortBy attribute is ignored. |           | 43.0        |        |
| `language`         | String         | The language in which the articles must be retrieved.                                                                                                                   |           | 43.0        |        |
| `pageNumber`       | Integer        | The current page number.                                                                                                                                                |           | 43.0        |        |
| `pageSize`         | Integer        | The number of articles displayed at once. The total number of articles displayed in a page cannot exceed 200.                                                           |           | 43.0        |        |
| `rendered`         | Boolean        | A Boolean value that specifies whether the component is rendered on the page. If not specified, this value defaults to true.                                            |           | 14.0        | global |
| `sortBy`           | String         | The sort value applied to the article list: 'mostViewed,' 'lastUpdated,' and 'title'. When the keyword attribute is specified, the sortBy attribute is ignored.         |           | 43.0        |        |