payloadcms / payloadcms/payload

Possibility to add new Collection View (not swap out the default one)

Open
#14,061 2 comments 0 reactions 1 assignee View on GitHub

@zubricks is already working on this.

Since Oct 3, 2025.

Dominant language
TypeScript
Stars
44.8k
Forks
4.2k
Avg merge
2d 21h
Merged PRs (30d)
53

Description

Documentation Issue

I wanted to add new Custom Collection View for list to some collection. I wanted to have two list views over the same collection, one should be the default one and the second should use custom component. I follow the documentation on Collection Views page, where it is written we can:

... swap out Collection Views with your own, or to create entirely new ones ...

Bellow that it is written that:

Any other key can be used to add a completely new Collection View. More details.

I've tried that, but it did not work, typescript shows me that it is possible to specify only edit and list view, any other key is not allowed. You can check it in a codebase: https://github.com/payloadcms/payload/blob/main/packages/payload/src/collections/config/types.ts#L357

Is this just an issue of documentation and a type definition? Or is there any way to create custom view for collection list next to the default one?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.