listCollections (List Collections)
Last updated: 2026-10-09
listCollections (List Collections)
listCollections lists the database's collections with their options (validator, collation, TTL, etc.). In mongosh use db.getCollectionNames() for names only or db.getCollectionInfos() for details. The filter argument narrows by name or type (e.g. views only). Results come back as a cursor to be iterated.
| Category | Admin Commands |
|---|---|
| MongoDB Version | 1.0+ |
| Example Language | mongosh (Shell) |
📝 Syntax
db.runCommand({ listCollections: 1, filter: { name: /^orders/ } })
db.getCollectionInfos({ name: /^orders/ })
⚙️ Parameters
| filter | Filter by name, type, options, etc. |
|---|---|
| nameOnly | Set true to return names only |
Returns:Returns a cursor whose firstBatch holds name, type, and options per collection
▶ Example
Run the commands below in your local mongosh (requires a running mongod):
// listCollections: print all collection names
use shop
db.getCollectionInfos().forEach((c) => print(c.name))
Output:
orders
products
users
📌 Notes
- Results are a cursor; iterate firstBatch for everything
- filter supports name, type, and options
- system.* collections are included by default; filter by name to exclude them
🏷️ Related Tags
💡 Related Cases
More hands-on cases coming soon.
📚 Related Tutorials
❓ FAQ
QlistCollections vs getCollectionNames?
AgetCollectionNames returns names only; listCollections includes per-collection options.
QCan I filter for views?
AUse filter: { type: 'view' } to list only views.
QWhat does it return?
AA cursor; iterate firstBatch for collection metadata.