What is MIME type "text/pdf"?

A MIME type is a string that tells browsers and other tools how to handle a particular kind of file.

The MIME type text/pdf is meant to label files that contain Portable Document Format data. However, the standard and widely accepted type for such documents is application/pdf.
When text/pdf is used, systems may treat the file content as plain text rather than a binary document. This can lead to issues in displaying the intended layouts and graphics.

Files in the PDF family—such as PDF—are designed to preserve fonts, images, and overall formatting across different platforms.

Main use case: Marking documents meant for fixed page layout and consistent appearance.
Technical note: The file is inherently binary, and using text/pdf may cause misinterpretation in text-based processing.
Best practice: Use application/pdf to ensure proper handling in browsers and applications.
Alternative usage: Some legacy systems or misconfigurations may set the type as text/pdf without changing the file’s core characteristics.

For more details on file handling and MIME types, visit this reference.

Associated file extensions

.pdf

Usage Examples

HTTP Header

When serving content with this MIME type, set the Content-Type header:


    Content-Type: text/pdf

HTML

In HTML, you can specify the MIME type in various elements:


    <a href="file.dat" type="text/pdf">Download file</a>

Server-side (Node.js)

Setting the Content-Type header in Node.js:


    const http = require('http');    
    
    http.createServer((req, res) => {    
      res.setHeader('Content-Type', 'text/pdf');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.pdf

FAQs

Is text/pdf the correct MIME type for PDF files?

No, text/pdf is not the standard MIME type. The official IANA standard for Portable Document Format files is application/pdf. Using the text primary type implies the content is human-readable, whereas PDFs are binary files containing complex layout data.

Why does my browser show raw code instead of the PDF document?

If a server sends the header Content-Type: text/pdf, browsers may treat the file as plain text rather than triggering the PDF viewer. This results in the browser displaying a stream of unreadable binary characters (garbage text) instead of the formatted document.

How do I fix the text/pdf MIME type error in Apache or Nginx?

You must configure your web server to associate the .pdf extension with application/pdf. In Apache, add AddType application/pdf .pdf to your .htaccess file. In Nginx, ensure your mime.types file is included or manually add types { application/pdf pdf; } to your server configuration.

Does using text/pdf affect how search engines index my documents?

While modern search engines like Google often inspect the file's actual content (magic numbers) to identify it as a PDF, using the wrong MIME type is bad practice. It may cause crawling errors or prevent the document from being properly categorized as a rich document in search results.

Can I open a file delivered as text/pdf in Adobe Acrobat?

Yes, if you download the file to your computer, the operating system usually relies on the file extension (e.g., .pdf) to choose the application. However, when viewing directly in a web browser, the MIME type takes precedence, likely causing the display issues described above.

Are there security risks associated with using text/pdf?

Yes, mislabeling binary content as text can sometimes lead to MIME sniffing vulnerabilities or Cross-Site Scripting (XSS) issues if a browser attempts to interpret the binary data as HTML or script. Always serve files with their correct, specific content type to ensure security headers like X-Content-Type-Options: nosniff work effectively.

General FAQ

What is a MIME type?

A MIME (Multipurpose Internet Mail Extensions) type is a standard that indicates the nature and format of a document, file, or assortment of bytes. MIME types are defined and standardized in IETF's RFC 6838.

MIME types are important because they help browsers and servers understand how to process a file. When a browser receives a file from a server, it uses the MIME type to determine how to display or handle the content, whether it's an image to display, a PDF to open in a viewer, or a video to play.

MIME types consist of a type and a subtype, separated by a slash (e.g., text/html, image/jpeg, application/pdf). Some MIME types also include optional parameters.

How do I find the MIME type for a file?

You can check the file extension or use a file identification tool such as file --mime-type on the command line. Many programming languages also provide libraries to detect MIME types.

Why are multiple MIME types listed for one extension?

Different applications and historical conventions may use alternative MIME identifiers for the same kind of file. Showing them all helps ensure compatibility across systems.