Content-Disposition

Baseline Widely available

This feature is well established and works across many devices and browser versions. Its been available across browsers since julio de 2015.

Learn more
See full compatibility

En una respuesta HTTP regular, el encabezado Content-Disposition indica si el contenido se espera que se muestre en lnea en el navegador, esto es, como una o como parte de una pgina web, o como un archivo adjunto, que se puede descargar y guardar localmente.

En un cuerpo multipart/form-data, el encabezado general Content-Disposition puede ser utilizado en la subparte de un cuerpo multipartes para dar informacin acerca del campo al que aplica. La subparte es delimitada por el boundary (lmite) definido en el encabezado Content-Type. Cuando se utiliza en el propio cuerpo, Content-Disposition no tiene efecto.

El encabezado Content-Disposition est definido en el contexto de mensajes MIME para correos electrnicos, pero slo un subconjuto de los parmetros posibles aplican a formularios HTTP y peticiones POST. Slo el valor form-data, como las directivas opcionales name and filename, pueden ser utilizadas en el contexto HTTP.

Tipo de encabezado	Response header (para el cuerpo principal) General header (para una subparte de un cuerpo multipartes)
Forbidden request header	no

Sintaxis

Como encabezado de respuesta para cuerpo principal

El primer parmetro en el contexto HTTP o es inline (valor predeterminado, indicando que puede ser mostrado dentro de una pgina web, o como la pgina web) o attachment (indicando que ser descargado; la mayora de los navegadores mostrando un dilogo 'Guardar como', prellenado con el valor del parmetro filename, en caso de estar presente).

Content-Disposition: inline
Content-Disposition: attachment
Content-Disposition: attachment; filename="filename.jpg"

Como encabezado para un cuerpo multipartes

El primer parmetro en el contexto HTTP siempre es form-data; parmetros adicionales son insensibles a maysculas y tienen argumentos que usan sintaxis de textos entre comillas despus del signo de '='. Mltiples parmetros se separan por punto y coma (';').

Content-Disposition: form-data
Content-Disposition: form-data; name="fieldName"
Content-Disposition: form-data; name="fieldName"; filename="filename.jpg"

Directivas

name: Es seguida de un texto que contiene el nombre del campo de HTML en el formulario a la que el contenido de la subparte refiere. Cuando se usan mltiples archivos en el mismo campo (por ejemplo, el atributo multiple de un elemento <input type=file>), puede haber varias subpartes con el mismo nombre. Un name con valor de '_charset_' indica que la parte no es un campo HTML, sino el conjunto de caracteres predeterminado para partes sin informacin explcita sobre su conjunto de caracteres.
filename: Es seguida de un texto que contiene el nombre original del archivo transmitido. Siempre es opcional y no debe ser utilizado a ciegas por la aplicacin: informacin sobre la ruta debe ser despojada, y se debe realizar una conversin a las reglas del sistema de archivos del servidor. Este parmetro provee mayormente informacin indicativa. Cuando se usa en combinacin con Content-Disposition: attachment, es utilizado como el nombre de archivo predeterminado en caso de que se presente al usuario un dilogo de 'Guardar como'.
filename*: Los parmetros filename y filename* difieren nicamente en que filename* utiliza encodeado definido en RFC 5987. Cuando ambos estn presentes en un valor de campo de encabezado simple, filename* es preferido sobre filename cuando ambos estn presentes y entendidos.

Ejemplos

Una respuesta generando el dilogo 'Guardar como':

200 OK
Content-Type: text/html; charset=utf-8
Content-Disposition: attachment; filename="genial.html"
Content-Length: 22

<HTML>Gurdame!</HTML>

Este archivo simple de HTML ser guardado como una descarga regular en lugar de mostrarse en el navegador. La mayora de los navegadores propondr guardarlo como genial.html ya que es el nombre (predeterminado).

Un ejemplo de un formulario HTML, publicado usando el formato multipart/form-data que hace uso del encabezado Content-Disposition:

POST /test.html HTTP/1.1
Host: example.org
Content-Type: multipart/form-data;boundary="boundary"

--boundary
Content-Disposition: form-data; name="campo1"

valor1
--boundary
Content-Disposition: form-data; name="campo2"; filename="ejemplo.txt"

valor2
--boundary--

Especificaciones

Specification
Use of the Content-Disposition Header Field in the Hypertext Transfer Protocol (HTTP) # header.field.definition
Returning Values from Forms: multipart/form-data # section-4.2

Compatibilidad con navegadores

Notas de compatibilidad

Firefox 5 maneja el encabezado de respuesta HTTP Content-Disposition ms efectivamente si ambos parmetros filename y filename* estn presentes; observa todos los nombres presentes, usando el parmetro filename* si uno est disponible, incluso si el parmetro filename est incluido antes. Previamente, el primer parmetro en encontrarse sera usado, de este modo se previene el uso de un nombre ms apropiado. Mira Error 588781 en Firefox.

Ver tambin

Formularios HTML
El Content-Type definiendo el lmite de un cuerpo multipartes.
La interfaz FormData usada para manipular datos de formulario para uso en la API XMLHttpRequest.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 9 abr 2026 by MDN contributors.

View this page on GitHub Report a problem with this content

Content-Disposition

In this article

Help improve MDN