---
title: "system.mongodb.deleteMany"
description: "Removes documents from the collection that match the filter."
---

# system.mongodb.deleteMany

> Removes documents from the collection that match the filter.

This function is used in **Python Scripting**.

:::note
Project Library scripts will not provide hints for MongoDB system functions unless the Script Hint Scope is set to **Gateway**. See the [Scripting in Ignition](platform\scripting\scripting-in-ignition\scripting-in-ignition.md#system-functions-hints-and-autocomplete) page for more details on scripting hints.
:::

## Description
## Client Permission Restrictions
This scripting function has no [Client Permission](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax
`system.mongodb.deleteMany(connector, collection, filter, [options])`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `connector` | The name of connector (case-insensitive).
String| `collection` | The name of collection (case-sensitive).
PyDictionary| `filter` | A PyDictionary for specifying matching key value pair criteria when querying a collection. 
PyDictionary| `options` | A PyDictionary for including additional delete configurations. [optional]

### Returns
**PyDictionary** `result` - Result of delete action formatted as a PyDictionary with keys ‘acknowledged’ and ‘deleteCount’.

### Scope
Gateway, Perspective Session

## Code Examples
```python title="Example #1"
# Specify unique field values to locate specific documents.
filter = {"qualityControlProcess":"V020"}
   
# Apply parameters for function call.
print system.mongodb.deleteMany("MongoDB", "data", filter)
```