How to Stop Inline Attachments in Apple Mail on macOS (Terminal & GUI Methods)

inline attachments

Inline attachments in Apple Mail, like images and PDFs, often appear directly in the body of the message instead of as separate downloadable files. While this can be useful in some cases, many users find it disruptive, especially when trying to forward or archive emails. If you want to turn off inline attachments, you can do it with a simple Terminal command or a few manual workarounds. Here’s exactly how.

How to Stop Inline Attachments in Mail on OS X

1. Terminal Method (Best Option)

This method disables inline attachment previews in Mail for all images, PDFs, and other files.

  1. Quit the Mail app if it’s open.
  2. Open Terminal (Applications > Utilities > Terminal).
  3. Paste the following command and press Return: defaults write com.apple.mail DisableInlineAttachmentViewing -bool yes
  4. Press Return again if needed.
  5. Restart the Mail app.

Once done, attachments like images and PDFs will now appear as icons rather than embedded content.

How to Revert This Setting

If you ever want to return to inline previews:

  1. Open Terminal.
  2. Enter the following command: defaults delete com.apple.mail DisableInlineAttachmentViewing
  3. Restart the Mail app again.

2. GUI Workaround for Sending Mail Without Inline Display

Apple Mail doesn’t provide a built-in toggle for this in the interface, but you can avoid inline behavior when sending by:

  • Compressing files before attaching (Right-click > Compress)
  • Attaching via “Attach File” icon, not drag-and-drop
  • Adding files from Finder instead of dragging into message body

These steps don’t change how you receive inline files, but they help prevent inline formatting on the sending end.

Tips for Managing Attachments in Mail

  • Use Preview to open attachments externally: Right-click the icon and choose “Open in Preview” instead of double-clicking.
  • Zip multiple files before attaching: It reduces confusion and avoids inline display.
  • Set Apple Mail to always send Windows-friendly attachments (Mail > Preferences > Composing > [check] “Send Windows-Friendly Attachments”).
  • Forward emails as attachments if you want to preserve original formatting.

Frequently Asked Questions

Will this affect all attachments?

It prevents inline display of most standard attachments like JPEGs, PNGs, PDFs, and more. Files will show as icons instead.

Is there a way to view images inline but not send them that way?

Yes. You can use drag-and-drop to attach images inline for yourself, and compress files when sending to avoid inline display for others.

Summary

  1. You can disable inline attachments with a quick Terminal command.
  2. GUI methods can help you avoid sending inline files, even if receiving remains unchanged.
  3. It’s fully reversible, just delete the Terminal setting.
  4. Compressing files or sending as icons helps with professional formatting.

Conclusion

If you prefer a cleaner, icon-based experience in Apple Mail, turning off inline attachments is a simple and effective solution. You can always undo the change if needed, so feel free to experiment and find what works best for your workflow.

2 thoughts on “How to Stop Inline Attachments in Apple Mail on macOS (Terminal & GUI Methods)

  • Didn’t work for me (Tahoe 26.5) but appreciate the effort.

    FWIW, I’d really rather an “attachment tray” kind of setup whereby you’d have a tray/window at the top of the message that you’d drag attachments to and, when viewing incoming messages, there’d be the same.

    All in all, I do surely wish Apple would overhaul Mail entirely. It feels ages old, and just patched & struggling.

  • WIth Sequoia Terminal needs Full Disk Access for defaults write com.apple.mail …
    Mail Settings Viewing Tab: Load Remote Content has been dropped.

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.