appengine: Index | Files

package mail

import ""

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


msg := &mail.Message{
	Sender:  "",
	To:      []string{"Juliet <>"},
	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)


Package Files


func Send Uses

func Send(c context.Context, msg *Message) error

Send sends an email message.

func SendToAdmins Uses

func SendToAdmins(c context.Context, msg *Message) error

SendToAdmins sends an email message to the application's administrators.

type Attachment Uses

type Attachment struct {
    // Name must be set to a valid file name.
    Name      string
    Data      []byte
    ContentID string

An Attachment represents an email attachment.

type Message Uses

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
    // for permissible headers.
    Headers mail.Header

A Message represents an email message. Addresses may be of any form permitted by RFC 822.

Package mail imports 6 packages (graph) and is imported by 53 packages. Updated 2020-06-16. Refresh now. Tools for package owners.