Last update:2026-07-28 14:38:39
In Protocol Settings, you can add, replace, or remove HTTP headers in selected request or response directions, and you can enable HTTP/2 for client connections.
Create an HTTP header rule to add, replace, or remove headers for selected request or response directions.
| Field | Description |
|---|---|
| Apply to | Select Specific File Type, Specific Directory, or URL Pattern (Regex). Use this field to scope the rule to the playback paths, file extensions, or URL patterns that require the header change. For Specific Directory, enter directory paths, one per line. |
| Action | Select Add, Replace, or Remove. Choose the action based on whether the header is missing, has the wrong value, or should not be passed in the selected direction. |
| HTTP Headers | Select the HTTP header to add, replace, or remove. |
| Custom HTTP Header | Enter a custom HTTP header. For Remove, you can enter multiple headers separated by semicolons (;). For Add and Replace, enter only one header. |
| Old Value | Appears for Replace. Enter the existing header value to be replaced. |
| New Value | Enter the new header value. |
| Apply Rule to | Select one or more directions: Request to Origin, Response to Client, Response from Origin, or Request from Client. See Choose the Right Direction for more details. |
| Priority | Enter the rule priority. |
The action determines how Atomile handles the selected HTTP header.
| Action | Behavior | Use When |
|---|---|---|
| Add | Adds a new HTTP header. Select a header and specify its value in New Value. | Atomile should add a header in the selected direction. |
| Replace | Replaces the value of an existing HTTP header. Select a header, then specify Old Value and New Value. | Atomile should replace a known header value with another value. |
| Remove | Removes one or more HTTP headers. Select one or more headers to remove, separated by semicolons (;). |
Atomile should remove the selected header from the selected direction. |
Restriction: Some headers support only specific actions and directions. If the selected header, action, and direction combination is not supported, the dialog displays an error.
The Apply Rule to field controls the traffic direction where Atomile processes the header. Select the direction based on who sends the message and who receives the modified message.
| Direction | Traffic Segment | What It Means | Common CDN and Streaming Use |
|---|---|---|---|
| Request from Client | Player, browser, or application to Atomile | A header sent by the playback client before Atomile handles the request | Handle request headers such as Accept, Accept-Encoding, Accept-Language, Referer, or User-Agent when the rule applies to client request metadata. |
| Request to Origin | Atomile to origin | A header sent by Atomile when it requests content from the origin | Add or replace origin-facing headers, such as a custom host or routing header required by the origin. |
| Response from Origin | Origin to Atomile | A header returned by the origin before Atomile returns the response to the client | Normalize origin response headers before Atomile continues response processing. |
| Response to Client | Atomile to player, browser, or application | A header visible to the playback client in the final Atomile response | Add response headers needed by playback clients, such as CORS headers or content-related headers. |
Enable HTTP/2 to let Atomile use HTTP/2 for client connections.
The HTTP/2 switch shows the enabled state.
Note: HTTP/2 enables HTTP/2 for client connections. To configure connections to your origin, use Origin Protocol Version. Not all products support HTTP/2 for origin connections. Contact Technical Support for more details.
| Category | Header | Supported Actions | Supported Directions |
|---|---|---|---|
| Accept-related | Access-Control-Allow-Origin |
Add, Replace, Remove | Response headers |
| Accept-related | Access-Control-Allow-Methods |
Add, Replace, Remove | Response headers |
| Accept-related | Accept |
Add, Replace, Remove | Request headers |
| Accept-related | Accept-Encoding |
Add, Replace, Remove | Request headers |
| Accept-related | Accept-Charset |
Add, Replace, Remove | Request headers |
| Accept-related | Accept-Language |
Add, Replace, Remove | Request headers |
| Accept-related | Accept-Ranges |
Add, Replace, Remove | Request headers |
| Content-related | Content-Base |
Replace | Response headers |
| Content-related | Content-Disposition |
Replace | Response headers |
| Content-related | Content-Encoding |
Replace | Response headers |
| Content-related | Content-Language |
Replace | Response headers |
| Content-related | Content-Location |
Replace | Response headers |
| Content-related | Content-MD5 |
Replace | Response headers |
| Content-related | Content-Range |
Replace | Response headers |
| Content-related | Content-Type |
Replace | Response headers |
| Cache-related | Vary |
Add, Replace, Remove | Response headers |
| State-related | Cookie |
Add, Replace, Remove | Request headers |
| State-related | Set-Cookie |
Add, Replace, Remove | Response headers |
| Other | Referer |
Replace | Request headers |
| Other | Server |
Replace | Response headers |
| Other | User-Agent |
Replace | Request headers |
| Other | Custom header | Add, Replace, Remove | Request or response headers |