The HTTPContent-Rangeresponse header is used inrange requests to indicate where the content of a response body belongs in relation to a complete resource.

It should only be included in206 Partial Content or416 Range Not Satisfiable responses.

Syntax

Content-Range: <unit> <range>/<size>Content-Range: <unit> <range>/*Content-Range: <unit> */<size>

Directives

<unit>

The unit for specifying ranges.Currently, onlybytes is supported.

<range>

A range with the format<range-start>-<range-end>, where<range-start> and<range-end> are integers for the start and end position (zero-indexed & inclusive) of the range in the given<unit>, respectively.* is used in a416 Range Not Satisfiable response to indicate that the value is not a range.

<size>

The total length of the document (or* if unknown).

Examples

Partial content response

This206 Partial Content response shows a partial response, with theContent-Range indicating that it contains the first 1024 bytes of a 146515 byte file.

HTTP/2 206content-type: image/jpegcontent-length: 1024content-range: bytes 0-1023/146515…(binary content)

Range not satisfiable

If the server cannot satisfy the requested range request, it should respond with a416 Range Not Satisfiable status, and theContent-Range should specify* for the range along with the total size of the resource.

HTTP/2 416Content-Range: bytes */67589

Specifications

Browser compatibility

See also

• HTTP range requests guide
• If-Range,Range headers
• Content-Type
• 206 Partial Content,416 Range Not Satisfiable status codes