---
title: "system.mes.changelog.createFilter"
id: "system-mes-changelog-createfilter"
project: "MES User Manual"
url: "https://docs.sepasoft.com/articles/user-manual/system-mes-changelog-createfilter"
updated: 2026-09-23T18:21:09Z
---

# system\.mes\.changelog\.createFilter

**Sepasoft MES Module Suite**

## createFilter()

## 

The **createFilter** script function creates and returns a **MESChangelogFilter** object. Use this object to define search constraints before calling any **system.mes.changelog** query function. By default the filter is configured with an inclusive date/version range, descending sort order, and no record limit.

### Syntax

system.mes.changelog.createFilter()

### Parameters

This function takes no parameters.

### Return Value
| Type | Description |
| --- | --- |
| [MESChangelogFilter](/articles/user-manual/meschangelogfilter) | A filter object with default settings: inclusive range, descending sort, no record limit. |
### Scope
| Context | Availability |
| --- | --- |
| Client | Available in Vision Client and Designer scripts |
| Gateway | Available in Gateway-scoped scripts |
### Example Usage

```python
# Minimal — create a filter and pass it directly to a query function
changelogFilter = system.mes.changelog.createFilter()
events = system.mes.changelog.getChangeEvents(filter=changelogFilter)

# Realistic workflow — configure the filter before querying
changelogFilter = system.mes.changelog.createFilter()
changelogFilter.setLimit(100)
changelogFilter.setDescending(True)
changelogFilter.setMESObjectTypeNames("Equipment")
events = system.mes.changelog.getChangeEvents(filter=changelogFilter)
```

### Related Functions:

* [getChangelogData()](/articles/user-manual/system-mes-changelog-getchangelogdata) — Returns an Ignition Dataset of changelog records using this filter.

**Sepasoft MES Module Suite**