> [!NOTE]
> **Note:** To get more information about this package, such as access to older versions, view [this package on pkg.go.dev](https://pkg.go.dev/google.golang.org/appengine/v2/mail).

<br />

Package mail provides the means of sending email from an
App Engine application.

Example:

```go
msg := &mail.Message{
    Sender:  "romeo@montague.com",
    To:      []string{"Juliet <juliet@capulet.org>"},
    Subject: "See you tonight",
    Body:    "Don't forget our plans. Hark, 'til later.",
}
if err := mail.Send(c, msg); err != nil {
    log.Errorf(c, "Alas, my user, the email failed to sendeth: %v", err)
}
```

## Functions

### func Send

```go
func Send(c context.Context, msg *Message) error
```
Send sends an email message.

### func SendToAdmins

```go
func SendToAdmins(c context.Context, msg *Message) error
```
SendToAdmins sends an email message to the application's administrators.

## Attachment

```go
type Attachment struct {
	// Name must be set to a valid file name.
	Name      string
	Data      []byte
	ContentID string
}
```
An Attachment represents an email attachment.

## Message

```go
type Message struct {
	// Sender must be set, and must be either an application admin
	// or the currently signed-in user.
	Sender  string
	ReplyTo string // may be empty

	// At least one of these slices must have a non-zero length,
	// except when calling SendToAdmins.
	To, Cc, Bcc []string

	Subject string

	// At least one of Body or HTMLBody must be non-empty.
	Body     string
	HTMLBody string

	Attachments []Attachment

	// Extra mail headers.
	// See https://cloud.google.com/appengine/docs/standard/go/mail/
	// for permissible headers.
	Headers mail.Header
}
```
A Message represents an email message.
Addresses may be of any form permitted by RFC 822.