# Changelog

URL: /code/systems/changelog · Id: `system:changelog`

> Changelog publishes what shipped in each Version as dated notes on the Site, in feeds and to subscribed Customers.

Changelog publishes what shipped in each [Version](/business/nouns/version) as dated notes on the [Site](/business/nouns/site), in feeds and to subscribed [Customers](/business/nouns/customer). Notes are written from merged [Changes](/business/nouns/change), so nothing ships unannounced.

## Summary
| Part | This System |
| --- | --- |
| Group | Moves to Code |
| Status | Live |
| Shelf | Front: offered from a Startup’s first days |

You can ask:

- “Publish what shipped this week”
- “Write release notes for this version”
- “Email customers about the new feature”

## What you get
| Part | This System |
| --- | --- |
| Starts | On for every Startup at creation, with nothing to install. |
| Built from | [Database](/code/platform/capabilities/database), [Email delivery](/systems/communications/email), [Apps and sites](/products/platform/apps-and-sites) |

## Nouns it owns
None.

## Verbs
| Verb | Object | Approval | Event |
| --- | --- | --- | --- |
| [Content.publish](/business/nouns/content/publish) | [Content](/business/nouns/content) | Asks first; waits 1 business hour | [`Content.published`](/business/events/Content.published) |

## Events
| Direction | Event | How |
| --- | --- | --- |
| Emits | [`Content.published`](/business/events/Content.published) | By [Content.publish](/business/nouns/content/publish) |

## States
None.

## Who operates it
| Part | This System |
| --- | --- |
| Accountable | [Product Lead](/agents/product/product-lead) |
| Team | [Product Team](/agents/product) |
| Seat | A role agent holds it until a Human is seated. |
| Autonomy | `supervised` |
| Also calls its Verbs | [Content Lead](/agents/marketing/content-lead) |

## Approvals and limits
| Verb | Rule | Detail |
| --- | --- | --- |
| [Content.publish](/business/nouns/content/publish) | A person says yes first | Waits 1 business hour |

## Processes that use it
| Process | How it uses it |
| --- | --- |
| [Launches](/workflows/processes/launches) | A step calls [Content.publish](/business/nouns/content/publish) |
| [Content marketing](/workflows/processes/content-marketing) | A step calls [Content.publish](/business/nouns/content/publish) |

## Rail underneath
None.

## Views and dashboards
| View | Shows | Metrics |
| --- | --- | --- |
| The [Product Lead](/agents/product/product-lead)’s view | The Metrics its accountable Role answers for. | [Activation rate](/agents/product#activation-rate), [Must-have share](/agents/product#must-have-share), [Active calling keys](/agents/product#active-calling-keys), [Declared Verb attempts](/agents/product#declared-verb-attempts), [Time to first call](/agents/product#time-to-first-call) |

## Access
What each Access level may call here.

| Access level | May call |
| --- | --- |
| `owner` | Every Verb (1) |
| `admin` | Nothing |
| `member` | Nothing |
| `viewer` | Nothing |

## Import and export
None.

## Fees and pricing
None.

## Availability and limits
| Part | This System |
| --- | --- |
| Status | Live |

## Compliance notes
Controls it carries:

- [Point-in-time recovery](/systems/trust-and-governance/controls/point-in-time-recovery)
- [Processing definitions](/systems/trust-and-governance/controls/processing-definitions)

## Related Systems
None.

## Example
A [b2d](/business/motions/b2d) [Dataset API](/products/templates/dataset-api) for sanctions screening adds two lists and retires a field. Changelog drafts the note from the merged Change and posts it at `/changelog`. It emails every Customer whose calls read the retired field, with the date it stops returning.