---
id: object/table/9500
type: object
title: Table 9500 "Email Item"
summary: Table 9500 "Email Item" in Base Application (System.Email). 26 fields, 18 public procedures, 3 events. Present since at least BC23, still in BC30, changed in BC24, BC26-28.
tier: official
language: en
tags:
  - table
  - base application
versions:
  introduced: null
  last_changed: "28"
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 05ed91f050b9105a27be94c7a11de601bc4d2fa2cdf7bc347df1b44416a69706
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Modules/System/Email/EmailItem.Table.al
    title: src/Layers/W1/BaseApp/Modules/System/Email/EmailItem.Table.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
links:
  learn: []
  objects: []
  features: []
  topics: []
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: table
object_id: 9500
name: Email Item
namespace: System.Email
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "24"
  - "26"
  - "27"
  - "28"
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids: []
counts:
  fields: 26
  procedures: 22
  events: 3
  subscribers: 0
relations:
  out: 0
  referenced_by: 0
  pages: 0
  extended_by: 1
  event_subscribers: 1
  calls: 4
  called_by: 0
  implements: 0
---

# Table 9500 "Email Item"

> Table 9500 "Email Item" in Base Application (System.Email). 26 fields, 18 public procedures, 3 events. Present since at least BC23, still in BC30, changed in BC24, BC26-28.

Base Application · System.Email · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Modules/System/Email/EmailItem.Table.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | Email Item |
| DataClassification | CustomerContent |

## Fields

Explanation: the field's ToolTip in the code; without one, the ToolTip of a page control bound to the field (marked via the page); without that, its Caption (marked caption) when that differs from the name.

| No. | Name | Type | Explanation | Notes |
|---|---|---|---|---|
| 1 | ID | Guid | — |  |
| 2 | From Name | Text[100] | — |  |
| 3 | From Address | Text[250] | — |  |
| 4 | Send to | Text[250] | — |  |
| 5 | Send CC | Text[250] | — |  |
| 6 | Send BCC | Text[250] | — |  |
| 7 | Subject | Text[250] | — |  |
| 8 | Body | BLOB | — |  |
| 9 | Attachment File Path | Text[250] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 10 | Attachment Name | Text[250] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 11 | Plaintext Formatted | Boolean | — |  |
| 12 | Body File Path | Text[250] | — | obsolete Pending 27.0; #if not CLEANSCHEMA30 |
| 13 | Message Type | Option | — | OptionCaption: Custom Message,From Email Body Template |
| 14 | Send as HTML | Boolean | — |  |
| 21 | Attachment File Path 2 | Text[250] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 22 | Attachment Name 2 | Text[50] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 23 | Attachment File Path 3 | Text[250] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 24 | Attachment Name 3 | Text[50] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 25 | Attachment File Path 4 | Text[250] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 26 | Attachment Name 4 | Text[50] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 27 | Attachment File Path 5 | Text[250] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 28 | Attachment Name 5 | Text[50] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 29 | Attachment File Path 6 | Text[250] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 30 | Attachment Name 6 | Text[50] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 31 | Attachment File Path 7 | Text[250] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |
| 32 | Attachment Name 7 | Text[50] | — | obsolete Removed 28.0; #if not CLEANSCHEMA28 |

## Keys

- Key1: ID (clustered)

## Events published

- `OnBeforeGetBodyText(var EmailItem: Record "Email Item"; var Value: Text; var IsHandled: Boolean)` (integration)
- `OnBeforeSend(var EmailItem: Record "Email Item"; var HideMailDialog: Boolean; var MailManagement: Codeunit "Mail Management"; var EmailScenario: Enum "Email Scenario"; var Result: Boolean; var Enqueue: Boolean; var IsHandled: Boolean)` (integration)
- `OnBeforeSetAttachments(var EmailItem: Record "Email Item"; var TempBlobList: Codeunit "Temp Blob List"; var Names: List of [Text])` (integration)

## Trigger event subscribers

- OnAttachIncomingDocumentsOnAfterSetFilter: [Codeunit 5579 "Digital Voucher Impl."](../codeunit/5579.md) ExcludeDigitalVouchersOnAttachIncomingDocumentsOnAfterSetFilter

## Procedures

- `HasAttachments(): Boolean`
- `GetAttachments(var TempBlobList: Codeunit "Temp Blob List"; var Names: List of [Text])`
- `SetAttachments(TempBlobList: Codeunit "Temp Blob List"; Names: List of [Text])`
- `AddAttachment(AttachmentStream: Instream; AttachmentName: Text)`
- `AddSourceDocument(TableID: Integer; SourceID: Guid)`
- `AddSourceDocument(TableID: Integer; SourceID: Guid; RelationType: Enum "Email Relation Type")`
- `GetSourceDocuments(var SourceTableList: List of [Integer]; var SourceIDList: List of [Guid]; var SourceRelationTypeList: List of [Integer])`
- `SetSourceDocuments(NewSourceTables: List of [Integer]; NewSourceIDs: List of [Guid]; NewSourceRelationTypes: List of [Integer])`
- `Initialize()`
- `Send(HideMailDialog: Boolean; EmailScenario: Enum "Email Scenario"): Boolean`
- `Send(HideMailDialog: Boolean; EmailScenario: Enum "Email Scenario"; Enqueue: Boolean): Boolean`
- `SetBodyText(Value: Text)`
- `SetBody(var TempBlob: Codeunit "Temp Blob")`
- `SetBody(var TempBlob: Codeunit "Temp Blob"; FormattedAsPlainText: Boolean)`
- `GetBodyText(): Text`
- `GetBodyTextFromBlob(): Text`
- `SendAsHTML(SendAsHTML: Boolean)`
- `ValidateTarget()`

Plus 1 local procedures.

## Extended by

- [Table extension 9900 "Email Item Attach Document"](../tableextension/9900.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 4102 "Temp Blob List"](../codeunit/4102.md) (2 calls: `AddAttachment → Add`, `HasAttachments → (object)`)
- [Codeunit 28 "Error Message Management"](../codeunit/28.md) (1 call: `ValidateTarget → LogSimpleErrorMessage`)
- [Codeunit 4100 "Temp Blob"](../codeunit/4100.md) (1 call: `AddAttachment → CreateOutStream`)
- [Codeunit 9520 "Mail Management"](../codeunit/9520.md) (1 call: `CorrectAndValidateEmailList → CheckValidEmailAddresses`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC24, BC26-28

## Deprecations

- field Body File Path: Pending 27.0 (#if not CLEANSCHEMA30), "Replaced with field Body. You can use the new procedure SetBody to update the value of the html formatted body."
- field Attachment File Path: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment File Path 2: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment File Path 3: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment File Path 4: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment File Path 5: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment File Path 6: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment File Path 7: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment Name: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment Name 2: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment Name 3: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment Name 4: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment Name 5: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment Name 6: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."
- field Attachment Name 7: Removed 28.0 (#if not CLEANSCHEMA28), "Replaced with method AddAttachment that accepts Streams."

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "table", object_name: "Email Item")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.