Manatee

"The file couldn't be opened because it isn't in the correct format"

“The file couldn’t be opened because it isn’t in the correct format” means the app read the start of the file, expected one kind of data, and found something else. The file may be fine and simply mislabeled, it may belong to a different app, it may be an unfinished download, it may be locked with a password, or it may be damaged. A minute in Finder and Terminal tells you which, and the fix follows from the answer.

What the message is really saying

This wording is a standard macOS error that any app can show when its file reader rejects what it finds. You will see it in TextEdit, and in plenty of other apps, worded identically, because the text comes from macOS rather than from the app.

The important part is what it does not say. It does not say the file is damaged. It says the contents do not match what this app expected from a file with that name. A perfectly healthy PDF named Report.docx produces exactly this message in a word processor.

Find out what the file really is

Quick Look first. Select the file in Finder and press the Space bar. If Quick Look shows the contents properly, the file is fine and the app you tried is the wrong one for it. Use File, Open With in Finder to pick another.

Then ask Terminal. Open Terminal (in Applications, Utilities), type file followed by a space, drag the file onto the window, and press Return. The file command ignores the name and reads the contents. Some answers you might see, and what they mean:

  • “Microsoft Word 2007+” or “Microsoft Excel 2007+”: a genuine modern Office document. If it still will not open, the problem is inside it.
  • “Zip archive data”: DOCX, XLSX, PPTX and EPUB files are all zip archives underneath, so this can be normal. It can also mean an Office file whose internal index is damaged, or a real zip someone renamed.
  • “Composite Document File V2 Document”: an older Office format, such as a .doc or .xls from before 2007, wearing a newer extension. Rename it with the old extension and it usually opens.
  • “CDFV2 Encrypted”: an Office document protected with a password. Only an app that supports Office passwords can open it, and only with the password. Ask the sender for the password or an unprotected copy.
  • “HTML document”: a web page. This is the classic sign of a failed download, where the site sent back an error or sign-in page and your browser saved it under the expected name. Download the file again, signed in if necessary.
  • “PDF document”, “JPEG image data” and similar: a perfectly good file with the wrong extension. Rename it to match.
  • “data”: nothing recognizable. The file is damaged, encrypted in some other way, or cut short.
  • “empty”: the file has no contents at all, and nothing can open or repair it. Look for another copy.

Check the size. Choose File, Get Info. If the sender says the file is 8 MB and you have 40 KB, you have a fragment, not the file. Download or copy it again.

See inside with TextEdit

TextEdit can show you the raw contents of a file without trying to interpret it, which settles a lot of questions quickly.

  1. Open TextEdit and choose File, Open.
  2. Select the file, then click Options at the bottom of the window if the extra settings are hidden.
  3. Check “Ignore rich text commands” and click Open.

A failed download shows up as readable web page code, often with a phrase like “access denied” or “sign in” somewhere inside it. A real Office file shows mostly gibberish starting with the letters PK, which is how every zip archive begins. A PDF starts with %PDF. Close the window without saving.

Fixes, by cause

The extension is wrong. Select the file, choose File, Get Info, and correct the extension under Name & Extension, using whatever the file command reported. Finder asks you to confirm the change. Changed a file extension and now it will not open covers the cases where a rename alone does not help.

The app is the wrong one. TextEdit opens Word documents but handles only part of what they can contain, and it shows this message for some files that Pages or Word open without trouble. Try Pages for Word documents, Numbers for spreadsheets and CSV files, and Preview for PDFs and images.

The file is newer than the app. A document saved by a recent version of an app can defeat an older copy of the same app. Update the app, or ask the sender to save in an older format.

The download or copy was incomplete. Fetch it again and compare sizes with the sender’s copy before you open it.

The file is damaged. This is the case when the file command reports the right type but the file still will not open anywhere, or reports “data” for something that should be a document. Manatee repairs Word documents, PDFs and video, and rebuilds the zip structure of XLSX, PPTX, EPUB and OpenDocument files. Drag the file onto its menu bar icon, or Control-click it in Finder and choose Services, then “Fix with Manatee”. It writes a repaired copy beside the original, never changes the original, and tells you plainly whether the result is Fixed, Partial or Not fixable. All of it runs on the Mac, so a sensitive document is never uploaded.

When the file is healthy and one particular app simply cannot read it, Manatee’s Convert mode can also make a copy that app can handle: a DOCX turned into RTF or plain text gives TextEdit a format it handles fully.

What Manatee will not do is open a file protected with a password it does not have, or read Pages, Numbers or Keynote documents. Those need the password, or Apple’s own apps.

Questions

Does this message mean my file is corrupted? Not necessarily. Far more often the name and the contents disagree, or the app is the wrong one. Run the file command before assuming the worst.

Can I fix it by adding .docx to the name? Only if the file command says it is a Word document. Renaming does not change what is inside, so a wrong extension makes things worse rather than better.

Every file in a folder gives this message. What happened? Something changed all of them on the way: a copy or sync that failed partway, an email system that altered attachments, or an archive that did not unpack properly. Check the sizes against the originals, and if they are short, copy them again. For a general checklist, see the file someone sent you will not open.