What is MIME type "text/x-typoscript"?

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

text/x-typoscript describes files that contain TypoScript code. It tells systems and text editors that the file has configuration commands designed for the TYPO3 CMS engine.

Developers use it to set up page templates, menus, and content rendering. This MIME type helps applications apply proper syntax highlighting and formatting. Files with this code usually use the TYPOSCRIPT extension.

Main use: Configure and control TYPO3 website behavior.
Key facts: Designed for the TYPO3 CMS; it instructs how content, layout, and functionality work.
Other uses: Supports syntax highlighting in editors and ensures correct processing by software tools.

This MIME type is essential for environments using TYPO3, as it distinguishes configuration files from other types of text files. For more detailed technical insights, visit Filext.

Associated file extensions

.typoscript

Usage Examples

HTTP Header

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


    Content-Type: text/x-typoscript

HTML

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


    <a href="file.dat" type="text/x-typoscript">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/x-typoscript');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.typoscript

FAQs

What is the purpose of the text/x-typoscript MIME type?

This MIME type identifies configuration files used by the TYPO3 CMS. It contains TypoScript code, which instructs the CMS on how to generate HTML, handle navigation menus, and process content elements.

How do I configure Apache to recognize .typoscript files?

You can map the extension by adding a directive to your .htaccess file or server configuration. Add the line AddType text/x-typoscript .typoscript to ensure Apache serves these files with the correct content type header.

Why does the MIME type start with 'x-'?

The x- prefix signifies that text/x-typoscript is a non-standard or experimental type not registered with the IANA. It is a vendor-specific identifier used exclusively within the TYPO3 ecosystem to distinguish its logic from standard text/plain files.

Do web browsers render text/x-typoscript files?

No, browsers do not have a built-in engine to interpret TypoScript code. If a user navigates directly to a .typoscript file, the browser will usually display it as raw text or trigger a file download.

Should I block public access to files with this MIME type?

Yes, for security reasons, it is best practice to prevent direct public access to configuration files. You should configure your web server (Nginx or Apache) to deny requests for files ending in .typoscript to prevent potential information disclosure.

What is the difference between .ts and .typoscript extensions?

Historically, TypoScript often used the .ts extension. However, .ts is now standard for TypeScript files. To avoid conflicts in IDEs and MIME detection, modern TYPO3 projects prefer the explicit .typoscript extension.

How do I add support for this type in Nginx?

To register this MIME type in Nginx, edit your mime.types file or the types block in your configuration. Add the line: text/x-typoscript typoscript;.

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.