> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: count(options: WixDataOptions)

# Method package: wixData

# Method menu location: wixData --> WixDataQuery --> count

# Method Link: https://dev.wix.com/docs/velo/apis/wix-data/wix-data-query/count.md

# Method Description:

Returns the number of items that match the query.

The `count()` function returns a Promise that resolves to the number of
 items that match the query. The Promise is rejected if `count()` is called
 with incorrect permissions or if any of the functions used to refine the
 query is invalid.

 Calling the `count()` function triggers the [`beforeCount()`](wix-data.Hooks.html#beforeCount)
 and [`afterCount()`](wix-data.Hooks.html#afterCount) hooks if they have been defined.

 Use the `options` parameter to run `count()` without checking for permissions
 or without its registered hooks.

 Any function that does not filter query results (e.g., [`ascending()`](#ascending))
 does not affect the result of `count()`.

 If you build a query and don't refine it with any `WixDataQuery` functions,
 `count()` returns the total number of items in the collection.

 If you have already run a query with [`find()`](#find), you can retrieve
 the number of query results without calling `count()`. The [`find()`](#find)
 function returns a Promise that resolves to a [`WixDataQueryResult`](https://dev.wix.com/docs/velo/api-reference/wix-data/wix-data-query-result/introduction.md)
 object, which has a `totalCount` property whose value is the number of results.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Perform a count on a query

```javascript
query.count()
  .then((num) => {
    let numberOfItems = num;
  })
  .catch((error) => {
    let errorMsg = error.message;
    let code = error.code;
  });
```

## Create a query and perform a count on it

```javascript
import wixData from 'wix-data';

// ...

wixData.query("myCollection")
  .count()
  .then((num) => {
    let numberOfItems = num;
  })
  .catch((error) => {
    let errorMsg = error.message;
    let code = error.code;
  });
```

## Create a query and perform a count on it

```javascript
import wixData from 'wix-data';

// ...

wixData.query("myCollection")
  .eq("status", "active")
  .gt("age", 25)
  .count()
  .then((num) => {
    let numberOfItems = num;
  })
  .catch((error) => {
    let errorMsg = error.message;
    let code = error.code;
  });
```

---