> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# helpCenterArticles

> Search the store's help center articles, by title unless `orderBy` says otherwise. To answer a customer, pass `visibleToShoppers: true` so only articles shoppers can read come back.

**Required scopes:** [`support_config_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_config_read)

## Arguments

**after** `String`

Forward pagination cursor — returns articles after it.

**before** `String`

Backward pagination cursor — returns articles before it.

**collection** `ID`

Only articles this collection lists (`collections`), as shoppers and `HelpCenterCollection.articles` see them.

**first** `Int`

Forward pagination: returns the first N articles (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N articles (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**orderBy** `[HelpCenterArticleSortKey](/docs/api-reference/v3/reference/support/help-center-article-sort-key)`

Which key to sort by. TITLE is A to Z; LAST\_EDITED\_AT is oldest first, never-saved articles first.

**page** `ID`

Only articles listed by a collection this page lists (`collections`).

**published** `Boolean`

Only published (true) or draft (false) articles.

**query** `String`

Only articles whose title or body text contains this text, case-insensitive. The body is matched as shoppers read it, without HTML tags and with entities decoded. At most 200 characters.

**reverse** `Boolean`

Reverses the direction `orderBy` sorts in.

**visibleToShoppers** `Boolean`

Only those shoppers see (true) or don't (false), by `visibleToShoppers`. Pass true when answering a customer.

## Returns

**helpCenterArticles** `[HelpCenterArticleConnection!](/docs/api-reference/v3/pagination)` *required*

A paginated list of HelpCenterArticle items.

**fields**

**edges** `[\[HelpCenterArticleEdge!\]!](/docs/api-reference/v3/pagination)` *required*

The list of edges (each a node plus its pagination `cursor`).

**fields**

**cursor** `String!` *required*

Opaque cursor for this item; pass to `after`/`before` to page from here.

**node** `[HelpCenterArticle!](/docs/api-reference/v3/reference/support/help-center-article)` *required*

The item at this edge.

**fields**

**collections** `[\[HelpCenterCollectionSummary!\]!](/docs/api-reference/v3/reference/support/help-center-collection-summary)` *required*

The collections that list the article, by title, each once. These are the collections shoppers find it under and whose `articles` include it. Empty when none lists it.

**Requires:** [`support_config_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_config_read)

**html** `String!` *required*

The article body as HTML, as saved in the dashboard's editor. Shoppers see it sanitized. Empty when none is saved.

**id** `ID!` *required*

m\_hca\_… id, the article id in the dashboard and in agent knowledge.

**lastEditedAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the article was last saved (the dashboard's Last updated). Null for an article never saved since that was recorded.

**published** `Boolean!` *required*

Whether the article itself is published (Published, not Draft, in the dashboard).

**title** `String!` *required*

The article's title. Empty when none is set.

**visibleToShoppers** `Boolean!` *required*

Whether shoppers see the article: it is published and listed by a collection shoppers see (`HelpCenterCollection.visibleToShoppers`).

**nodes** `[\[HelpCenterArticle!\]!](/docs/api-reference/v3/reference/support/help-center-article)` *required*

The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.

**fields**

**collections** `[\[HelpCenterCollectionSummary!\]!](/docs/api-reference/v3/reference/support/help-center-collection-summary)` *required*

The collections that list the article, by title, each once. These are the collections shoppers find it under and whose `articles` include it. Empty when none lists it.

**Requires:** [`support_config_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_config_read)

**fields**

**description** `String!` *required*

The collection's description. Empty when none is set.

**id** `ID!` *required*

m\_hcc\_… id, the collection id in the dashboard.

**published** `Boolean!` *required*

Whether the collection itself is published.

**title** `String!` *required*

The collection's title.

**visibleToShoppers** `Boolean!` *required*

Whether shoppers see the collection: the store's help desk is on, the collection is published, a published page lists it, and it lists at least one published article.

**html** `String!` *required*

The article body as HTML, as saved in the dashboard's editor. Shoppers see it sanitized. Empty when none is saved.

**id** `ID!` *required*

m\_hca\_… id, the article id in the dashboard and in agent knowledge.

**lastEditedAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the article was last saved (the dashboard's Last updated). Null for an article never saved since that was recorded.

**published** `Boolean!` *required*

Whether the article itself is published (Published, not Draft, in the dashboard).

**title** `String!` *required*

The article's title. Empty when none is set.

**visibleToShoppers** `Boolean!` *required*

Whether shoppers see the article: it is published and listed by a collection shoppers see (`HelpCenterCollection.visibleToShoppers`).

**pageInfo** `[PageInfo!](/docs/api-reference/v3/pagination)` *required*

Pagination metadata for the current page.

**fields**

**endCursor** `String`

Cursor of the last edge in this page; pass to `after` to page forward.

**hasNextPage** `Boolean!` *required*

Whether more items exist after this page (drives forward pagination with `first`/`after`).

**hasPreviousPage** `Boolean!` *required*

Whether more items exist before this page (drives backward pagination with `last`/`before`).

**startCursor** `String`

Cursor of the first edge in this page; pass to `before` to page backward.

## Example

```graphql theme={null}
query {
  helpCenterArticles(after: "...", before: "...", collection: "...", first: 10, last: 10, orderBy: LAST_EDITED_AT, page: "...", published: true, query: "...", reverse: true, visibleToShoppers: true) {
    nodes {
      html
      id
      lastEditedAt
      published
      title
      visibleToShoppers
    }
    pageInfo { hasNextPage endCursor }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.