These days, almost all websites & apps need to email their users as well as administrators on a regular basis. For example, you may need to email users for account activation, password reset, newsletters, and even send error notifications to administrators. If you are running a Python-based website or app, then you can easily do this from within your site or app itself. In this tutorial, we will learn how to send HTML email with attachments using Python’s smtplib library First, we will learn the individual steps involved in this process. Then we will put them together to get the complete code. 1. Import Smtplib We need to import Smtplib, which provides many out-of-the-box functions to quickly configure and send emails using Python. import smtplib 2. Import Email Package Next, we need to import a few necessary functions from the email package, that allow you to easily define and manage email messages. Among them, we will import MIMEBase, MIMEText, and MIMEMultipart classes. import email
from email import encoders
from email.mime.base import MIMEBase
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart MIMEBase allows you to set the content header of email messages. MIMEText allows you to set the email text and MIMEMultipart allows you to manage emails & its attachments. 3. Create MIMEMultipart Object We need to create a MIMEMultipart object which includes the email subject, sender, recipient, and file path of attachment. msg = MIMEMultipart("alternative")
msg["Subject"] = "multipart test"
msg["From"] = sender_email
msg["To"] = receiver_email
filename = "document.pdf" We will define sender_email & receiver_email values below when we put everything together. 4. Create HTML Message Next, we create an HTML message. First, we define a string to contain the entire message. html = """\
<html>
 <body>
 Python Mail Test 
 This is an HTML email with attachment. 
 Click on <a href="https://techosha.com">Techosha Resources</a> 
 for more python articles.
 
 </body>
</html>
""" Then, we create MIMETextObject from this string. part = MIMEText(html, "html") Lastly, we attach the file to the MIMEMultipart object we created above. msg.attach(part) 5. Add Attachment We will open the attachment file using open() function, set its content header as ‘application/octet-stream’ using MIMEBase() function and lastly, attach it to the message using set_payload() function. with open(filename, "rb") as attachment:
 part = MIMEBase("application", "octet-stream")
 part.set_payload(attachment.read()) We will also encode our attachment to send email. encoders.encode_base64(part) We also need to add a ‘Content-Disposition’ header to the attachment before sending the email. part.add_header(
 "Content-Disposition",
 "attachment", filename= filename
)
msg.attach(part) If you do not want to add an attachment, you can skip this step. 6. Create SMTP Connection We will create an SMTP connection, using smtplib.SMTP_SSL() function, to send emails. It will require login credentials of your email account. For our example, we will be using GMail servers. That is why we have mentioned ‘smtp.gmail.com’ below. Replace sender_email and password below with your GMail address and its password. It is the sendmail() function that does the actual sending of email. context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
 server.login(sender_email, password)
 server.sendmail(
 sender_email, receiver_email, msg.as_string()
 ) 7. Putting it together Now we will look at the complete code to send emails in Python. Create an empty Python file. $ sudo vi /home/email.py Add the following code to it. Replace SENDER_EMAIL_ADDRESS with your GMail address that you will use to send emails. Replace PASSWORD with its password. Replace RECEIVER_EMAIL_ADDRESS with the email address of email recipient. Replace document.pdf with the full file path to your attachment file. import smtplib, ssl, email
from email import encoders
from email.mime.base import MIMEBase
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

sender_email = "SENDER_EMAIL_ADDRESS"
receiver_email = "RECEIVER_EMAIL_ADDRESS"
password = "PASSWORD"

#Create MIMEMultipart object
msg = MIMEMultipart("alternative")
msg["Subject"] = "multipart test"
msg["From"] = sender_email
msg["To"] = receiver_email
filename = "document.pdf"

#HTML Message Part
html = """\
<html>
 <body>
 Python Mail Test
 
 This is HTML email with attachment. 
 Click on <a href="https://fedingo.com">Fedingo Resources</a> 
 for more python articles.
 
 </body>
</html>
"""

part = MIMEText(html, "html")
msg.attach(part)

# Add Attachment
with open(filename, "rb") as attachment:
 part = MIMEBase("application", "octet-stream")
 part.set_payload(attachment.read())
 
encoders.encode_base64(part)

# Set mail headers
part.add_header(
 "Content-Disposition",
 "attachment", filename= filename
)
msg.attach(part)

# Create secure SMTP connection and send email
context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
 server.login(sender_email, password)
 server.sendmail(
 sender_email, receiver_email, msg.as_string()
 ) Save and close the file. You can test the above Python script using the following command. $ sudo python /home/mail.py That’s it! In this tutorial, we have learned how to create and send an HTML email with attachments in Python. To summarize, create MIMEText() and MIMEMultipart() objects, and assemble them to create the complete email message along with required headers. Use sendmail() function to send emails. These days, almost all websites & apps need to email their users as well as administrators on a regular basis. For example, you may need to email users for account activation, password reset, newsletters, and even send error notifications to administrators. If you are running a Python -based website or app, then you can easily do this from within your site or app itself. In this tutorial, we will learn how to send HTML email with attachments using Python’s smtplib library Python First, we will learn the individual steps involved in this process. Then we will put them together to get the complete code. 1. Import Smtplib We need to import Smtplib, which provides many out-of-the-box functions to quickly configure and send emails using Python. import smtplib import smtplib 2. Import Email Package Next, we need to import a few necessary functions from the email package, that allow you to easily define and manage email messages. Among them, we will import MIMEBase, MIMEText, and MIMEMultipart classes. import email
from email import encoders
from email.mime.base import MIMEBase
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart import email
from email import encoders
from email.mime.base import MIMEBase
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart MIMEBase allows you to set the content header of email messages. MIMEText allows you to set the email text and MIMEMultipart allows you to manage emails & its attachments. 3. Create MIMEMultipart Object We need to create a MIMEMultipart object which includes the email subject, sender, recipient, and file path of attachment. msg = MIMEMultipart("alternative")
msg["Subject"] = "multipart test"
msg["From"] = sender_email
msg["To"] = receiver_email
filename = "document.pdf" msg = MIMEMultipart("alternative")
msg["Subject"] = "multipart test"
msg["From"] = sender_email
msg["To"] = receiver_email
filename = "document.pdf" We will define sender_email & receiver_email values below when we put everything together. 4. Create HTML Message Next, we create an HTML message. First, we define a string to contain the entire message. html = """\
<html>
 <body>
 Python Mail Test 
 This is an HTML email with attachment. 
 Click on <a href="https://techosha.com">Techosha Resources</a> 
 for more python articles.
 
 </body>
</html>
""" html = """\
<html>
 <body>
 Python Mail Test 
 This is an HTML email with attachment. 
 Click on <a href="https://techosha.com">Techosha Resources</a> 
 for more python articles.
 
 </body>
</html>
""" Then, we create MIMETextObject from this string. part = MIMEText(html, "html") part = MIMEText(html, "html") Lastly, we attach the file to the MIMEMultipart object we created above. msg.attach(part) msg.attach(part) 5. Add Attachment We will open the attachment file using open() function, set its content header as ‘application/octet-stream’ using MIMEBase() function and lastly, attach it to the message using set_payload() function. with open(filename, "rb") as attachment:
 part = MIMEBase("application", "octet-stream")
 part.set_payload(attachment.read()) with open(filename, "rb") as attachment:
 part = MIMEBase("application", "octet-stream")
 part.set_payload(attachment.read()) We will also encode our attachment to send email. encoders.encode_base64(part) encoders.encode_base64(part) We also need to add a ‘Content-Disposition’ header to the attachment before sending the email. part.add_header(
 "Content-Disposition",
 "attachment", filename= filename
)
msg.attach(part) part.add_header(
 "Content-Disposition",
 "attachment", filename= filename
)
msg.attach(part) If you do not want to add an attachment, you can skip this step. 6. Create SMTP Connection We will create an SMTP connection, using smtplib.SMTP_SSL() function, to send emails. It will require login credentials of your email account. For our example, we will be using GMail servers. That is why we have mentioned ‘smtp.gmail.com’ below. Replace sender_email and password below with your GMail address and its password. It is the sendmail() function that does the actual sending of email. sender_email password context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
 server.login(sender_email, password)
 server.sendmail(
 sender_email, receiver_email, msg.as_string()
 ) context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
 server.login(sender_email, password)
 server.sendmail(
 sender_email, receiver_email, msg.as_string()
 ) 7. Putting it together Now we will look at the complete code to send emails in Python. Create an empty Python file. $ sudo vi /home/email.py $ sudo vi /home/email.py Add the following code to it. Replace SENDER_EMAIL_ADDRESS with your GMail address that you will use to send emails. Replace PASSWORD with its password. Replace RECEIVER_EMAIL_ADDRESS with the email address of email recipient. Replace document.pdf with the full file path to your attachment file. import smtplib, ssl, email
from email import encoders
from email.mime.base import MIMEBase
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

sender_email = "SENDER_EMAIL_ADDRESS"
receiver_email = "RECEIVER_EMAIL_ADDRESS"
password = "PASSWORD"

#Create MIMEMultipart object
msg = MIMEMultipart("alternative")
msg["Subject"] = "multipart test"
msg["From"] = sender_email
msg["To"] = receiver_email
filename = "document.pdf"

#HTML Message Part
html = """\
<html>
 <body>
 Python Mail Test
 
 This is HTML email with attachment. 
 Click on <a href="https://fedingo.com">Fedingo Resources</a> 
 for more python articles.
 
 </body>
</html>
"""

part = MIMEText(html, "html")
msg.attach(part)

# Add Attachment
with open(filename, "rb") as attachment:
 part = MIMEBase("application", "octet-stream")
 part.set_payload(attachment.read())
 
encoders.encode_base64(part)

# Set mail headers
part.add_header(
 "Content-Disposition",
 "attachment", filename= filename
)
msg.attach(part)

# Create secure SMTP connection and send email
context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
 server.login(sender_email, password)
 server.sendmail(
 sender_email, receiver_email, msg.as_string()
 ) import smtplib, ssl, email
from email import encoders
from email.mime.base import MIMEBase
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

sender_email = "SENDER_EMAIL_ADDRESS"
receiver_email = "RECEIVER_EMAIL_ADDRESS"
password = "PASSWORD"

#Create MIMEMultipart object
msg = MIMEMultipart("alternative")
msg["Subject"] = "multipart test"
msg["From"] = sender_email
msg["To"] = receiver_email
filename = "document.pdf"

#HTML Message Part
html = """\
<html>
 <body>
 Python Mail Test
 
 This is HTML email with attachment. 
 Click on <a href="https://fedingo.com">Fedingo Resources</a> 
 for more python articles.
 
 </body>
</html>
"""

part = MIMEText(html, "html")
msg.attach(part)

# Add Attachment
with open(filename, "rb") as attachment:
 part = MIMEBase("application", "octet-stream")
 part.set_payload(attachment.read())
 
encoders.encode_base64(part)

# Set mail headers
part.add_header(
 "Content-Disposition",
 "attachment", filename= filename
)
msg.attach(part)

# Create secure SMTP connection and send email
context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
 server.login(sender_email, password)
 server.sendmail(
 sender_email, receiver_email, msg.as_string()
 ) Save and close the file. You can test the above Python script using the following command. $ sudo python /home/mail.py $ sudo python /home/mail.py That’s it! In this tutorial, we have learned how to create and send an HTML email with attachments in Python. To summarize, create MIMEText() and MIMEMultipart() objects, and assemble them to create the complete email message along with required headers. Use sendmail() function to send emails.

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

How to Split String Every Nth Character in Python

Too Long; Didn't Read

Make resilience your competitive advantage

How to Send HTML Emails with Attachments Using Python

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

How to Split String Every Nth Character in Python

2 Easy Methods to Create a Mail Merge for Gmail

4 Tricks to Increase Email Conversions and Make it Rain Baby

4 Ways to Get More Authentic Email Newsletter Subscribers

6 Code Optimization Tips For Building Email Templates

How to Split String Every Nth Character in Python

2 Easy Methods to Create a Mail Merge for Gmail

4 Tricks to Increase Email Conversions and Make it Rain Baby

4 Ways to Get More Authentic Email Newsletter Subscribers

6 Code Optimization Tips For Building Email Templates

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps