English ▼
Skip to page content Skip to main navigation
e.g. "templates" or "datastore"

# Attachments

An email message can include file attachments. The `attachments` field of an email message accepts a list of two-value tuples, one tuple for each attachment. The first element of the tuple is the filename to use for the attachment in the message, and the second element is the data, as a byte string.

    from google.appengine.api import mail
    from google.appengine.ext import db

    class DocFile(db.Model):
        doc_name = db.StringProperty()
        doc_file = db.BlobProperty()

    q = db.GqlQuery("SELECT * FROM DocFile WHERE doc_name = :1", myname)
    results = q.fetch(1)
    if results:
        doc = results[0]
        mail.send_mail(sender="support@example.com",
                      to="Albert Johnson <Albert.Johnson@example.com>",
                      subject="The doc you requested",
                      body="""
    Attached is the document file you requested.

    The example.com Team
    """,
                      attachments=[(doc.doc_name, doc.doc_file)])

As a security measure to protect against viruses, you cannot send email attachments—or zip files—containing any of the following extensions:

- ade
- adp
- bat
- chm
- cmd
- com
- cpl
- exe
- gzip
- hta
- ins
- isp
- jse
- lib
- mde
- msc
- msp
- mst
- pif
- scr
- sct
- shb
- sys
- vb
- vbe
- vbs
- vxd
- wsc
- wsf
- wsh
- zip