---
sidebar_position: 1
keywords:
- EventCatalog services
- Changelogs
sidebar_label: What are changelogs?
title: Understanding changelogs
description: What are changelogs
---

In your architecture, various resources like domains, services, schemas, and boundaries are constantly evolving. **Unfortunately, the context or reason behind these changes often gets lost.**

EventCatalog changelogs allow you to capture these changes and help your team understand the history of your architecture.

### Features

- Powered by markdown, add a `changelog.mdx` to your domains, services and messages
- Automated diffs for `.json`, `.avro`, `.yml` and `.yaml` files.
- Custom components and MDX component support
- Timestamps and linear history on page




#### Example

<!-- ![Example](/assets/images/changelog-b60ba4ecaafb228a61fd5a517d3c1428.png) -->

![Example](/img/blogs/changelog.png)

[You can see a changelog example here](https://demo.eventcatalog.dev/docs/events/InventoryAdjusted/1.0.1/changelog).

<!-- http://localhost:3000/assets/images/changelog-b60ba4ecaafb228a61fd5a517d3c1428.png -->
