diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/topics/email.txt | 15 |
1 files changed, 12 insertions, 3 deletions
diff --git a/docs/topics/email.txt b/docs/topics/email.txt index c29eae5d74..d8e8f177d5 100644 --- a/docs/topics/email.txt +++ b/docs/topics/email.txt @@ -476,17 +476,26 @@ email backend API :ref:`provides an alternative directly to the resulting message. For example, to attach an inline image with a :mailheader:`Content-ID`:: + import email.utils + from email.message import MIMEPart + from django.core.mail import EmailMultiAlternatives + + message = EmailMultiAlternatives(...) + image_data_bytes = ... # Load image as bytes + + # Create a random Content-ID, including angle brackets cid = email.utils.make_msgid() inline_image = email.message.MIMEPart() inline_image.set_content( image_data_bytes, maintype="image", - subtype="png", + subtype="png", # or "jpeg", etc. depending on the image type disposition="inline", - cid=f"<{cid}>", + cid=cid, ) message.attach(inline_image) - message.attach_alternative(f'… <img src="cid:${cid}"> …', "text/html") + # Refer to Content-ID in HTML without angle brackets + message.attach_alternative(f'… <img src="cid:{cid[1:-1]}"> …', "text/html") Python's :meth:`email.contentmanager.set_content` documentation describes the supported arguments for ``MIMEPart.set_content()``. |