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

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

text/x-lua is the MIME type for files that contain Lua scripting code.
This type tells computers and software that the file is plain text with embedded instructions written in Lua, a fast and flexible scripting language.
It helps text editors and web servers provide proper syntax highlighting and correct processing of the scripting content.
Its main use is to store and share Lua source code. It also works in contexts like embedded scripting and configuration in various applications.

Scripting for games and interactive applications.
Automation tasks within software and tools.
Web server scripting to deliver dynamic content.
Plugin and module development for expanding application features.

Files using this MIME type can come with several naming conventions. For example, a script might use the extension LUA. Other related formats include P8, NSE, FCGI, LUAU, PD_LUA, RBXS, ROCKSPEC, and WLUA.
A less common case is a file with the extension T, used for Terra— a language that integrates with Lua.
For further reading on MIME types, visit MIME Types on MDN.

Associated file extensions

.lua, .p8, .nse, .t, .fcgi, .luau, .pd_lua, .rbxs, .rockspec, .wlua

Usage Examples

HTTP Header

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


    Content-Type: text/x-lua

HTML

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


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

Associated file extensions

.lua, .p8, .nse, .t, .fcgi, .luau, .pd_lua, .rbxs, .rockspec, .wlua

FAQs

How do I configure Apache or Nginx to serve Lua files?

To ensure browsers recognize Lua files as text, you must update your MIME configuration. For Apache, add AddType text/x-lua .lua to your .htaccess file. For Nginx, add text/x-lua lua; to your mime.types file or inside the types block.

Will web browsers execute text/x-lua files automatically?

No, web browsers do not natively execute Lua code like they do JavaScript. If a server sends a file with the text/x-lua MIME type, the browser will typically display the source code as plain text. To run Lua on the web, you would need a transpiler or a specific server-side environment like OpenResty.

What is the difference between text/x-lua and application/x-lua?

text/x-lua is used for human-readable source code, allowing browsers to display the content inline. application/x-lua is often used for compiled Lua bytecode or when the server intends for the user to download the file rather than view it.

Why are formats like .p8 or .rockspec associated with this MIME type?

While .lua is the standard extension, many tools use Lua for configuration or embedded data. For example, P8 files are PICO-8 game cartridges storing Lua code, and ROCKSPEC files describe LuaRocks packages. They are all fundamentally text files containing Lua syntax.

Is it safe to open a file with the text/x-lua MIME type?

Yes, viewing the file is safe because it is just plain text. However, you should never execute a Lua script from an unknown source on your computer or server, as scripts can be written to modify files or access network resources maliciously.

How do I fix a '406 Not Acceptable' error when requesting a Lua file?

This error often occurs if the client requests a specific content type that the server isn't configured to provide. Ensure your server is explicitly configured to return text/x-lua for extensions like .lua or .wlua, and check that the client's Accept header allows for text-based responses.

Can I use text/x-lua for Roblox scripts?

Yes, Roblox scripts often use the .rbxs or .luau extensions, which fall under the text/x-lua umbrella. While Roblox uses a modified version of Lua called Luau, the underlying file structure remains plain text compatible with standard Lua editors.

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.