---
id: feature/573360
type: feature
title: Check records for uncommitted changes
summary: 'Development: Check records for uncommitted changes. Generally available, GA 2026-10 (Microsoft 365 roadmap). "Use the Record API IsDirty property to determine whether a record instance contains unsaved changes before deciding to validate, save, or otherwise process it. Business value: AL developers can determine whether a record instance has been changed before deciding to save it, validate it, or prompt the user. This can simplify conditional persistence and reduce unnecessary database operations."'
tier: official
language: en
system: development
tags:
  - development
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-07T23:41:05.192Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 5eb278787f3fa3ffb36cafb20de79c7c16730ebb51c5f32f3acbc94312bdec37
evidence:
  - kind: roadmap
    url: https://www.microsoft.com/microsoft-365/roadmap?id=573360
    title: Microsoft 365 roadmap 573360
    date: "2026-09-30"
    commit: null
    t: null
    quote: null
  - kind: video
    url: https://www.youtube.com/watch?v=D_Lur52IrIg&t=1202s
    title: "What's new in AL and Tools (2026 release wave 2): Record.IsDirty() method"
    date: null
    commit: null
    t: 1202
    quote: null
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos:
    - video/D_Lur52IrIg
  posts: []
  guidelines: []
roadmap_id: "573360"
wave: 2026 release wave 2
status: ga
roadmap_status: Launched
release_phase: General Availability
ga_date: 2026-10
preview_date: null
area: Development
whatsnew_url: null
localizations: []
objects_touched: []
---

# Check records for uncommitted changes

> Development: Check records for uncommitted changes. Generally available, GA 2026-10 (Microsoft 365 roadmap). "Use the Record API IsDirty property to determine whether a record instance contains unsaved changes before deciding to validate, save, or otherwise process it. Business value: AL developers can determine whether a record instance has been changed before deciding to save it, validate it, or prompt the user. This can simplify conditional persistence and reduce unnecessary database operations."

[Microsoft 365 roadmap 573360](https://www.microsoft.com/microsoft-365/roadmap?id=573360) · Development · generally available · roadmap status "Launched", phase General Availability

## What Microsoft says

"Use the Record API IsDirty property to determine whether a record instance contains unsaved changes before deciding to validate, save, or otherwise process it. Business value: AL developers can determine whether a record instance has been changed before deciding to save it, validate it, or prompt the user. This can simplify conditional persistence and reduce unnecessary database operations."

## Dates

- General availability: October CY2026 (2026 release wave 2)
- Public preview: not given
- On the roadmap since 2026-09-30, last changed 2026-09-30

## Covered by

Matched by Haiku among videos and Learn pages in the same galaxy system, checked against the roadmap ids and the evidence text. Every link below was reviewed by Opus.

### Videos

- [What's new in AL and Tools (2026 release wave 2)](../videos/D_Lur52IrIg.md): Record.IsDirty() method at [20:02](https://www.youtube.com/watch?v=D_Lur52IrIg&t=1202s)

Source: Microsoft 365 roadmap. Status words follow the roadmap.