Skip to content

Remove references to mirage as part of decommissioning work #25788

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 2 commits into from
Closed

Remove references to mirage as part of decommissioning work #25788

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5abec44
Remove references to mirage as part of decommissioning work
mglewis Oct 13, 2025
69d675d
Remove period
pedrosousa Oct 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion public/__redirects
View file
Open in desktop
Copy link
Contributor

@pedrosousa pedrosousa Oct 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: We still need to add a redirect for /speed/optimization/images/mirage/, being deleted in this PR.

Original file line number Diff line number Diff line change
Expand Up @@ -1335,7 +1335,6 @@
## end block
/fundamentals/network/0-rtt-connection-resumption/ /speed/optimization/protocol/0-rtt-connection-resumption/ 301
/support/speed/essentials/will-cloudflares-image-optimization-features-help-if-im-already-optimizing-images/ /speed/optimization/images/troubleshooting/multiple-optimizations/ 301
/support/speed/optimization-delivery/configuring-cloudflare-mirage/ /speed/optimization/images/mirage/ 301
/support/speed/optimization-mobile/understanding-cloudflare-mobile-redirect/ /speed/optimization/other/mobile-redirect/ 301
/support/speed/optimization-file-size/using-cloudflare-auto-minify/ /speed/optimization/content/ 301
/support/speed/optimization-file-size/what-will-cloudflare-compress/ /speed/optimization/content/compression/ 301
Expand Down
1 change: 0 additions & 1 deletion src/content/docs/cache/get-started.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,6 @@ Review the list of Cloudflare features that function in this manner:

* [Rocket Loader](/speed/optimization/content/rocket-loader/)
* [Polish](/images/polish/)
* [Mirage](/speed/optimization/images/mirage/) (deprecated)
* [Hotlink Protection](/waf/tools/scrape-shield/hotlink-protection/)
* [Email address obfuscation](/waf/tools/scrape-shield/email-address-obfuscation/)
* [Bot Management JavaScript Detections](/bots/additional-configurations/javascript-detections/)
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/cache/reference/etag-headers.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ The Cloudflare network will take the following actions, depending on the visitor

</table-wrap>

Enabling **Respect Strong ETags** in Cloudflare automatically disables Rocket Loader, Email Obfuscation, Automatic HTTPS Rewrites, and Mirage.
Enabling **Respect Strong ETags** in Cloudflare automatically disables Rocket Loader, Email Obfuscation and Automatic HTTPS Rewrites.

### Behavior with Respect Strong ETags disabled

Expand Down
1 change: 0 additions & 1 deletion ...lare-for-platforms/cloudflare-for-saas/saas-customers/product-compatibility.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,6 @@ This is not an exhaustive list of Cloudflare products and features.
| [IPv6 Compatibility](/network/ipv6-compatibility/) | Yes | Yes\* | If the customer zone has **IPv6 Compatibility** enabled, generally the SaaS zone should as well.<br/><br/>If not, make sure the SaaS zone enables [Pseudo IPv4](/network/pseudo-ipv4/). |
| [Load Balancing](/load-balancing/) | No | Yes | Customer zones can still use Load Balancing for non-O2O traffic. |
| [Page Rules](/rules/page-rules/) | Yes\* | Yes | Page Rules that match the subdomain used for O2O may block or interfere with the flow of visitors to your website. |
| [Mirage](/speed/optimization/images/mirage/) (deprecated) | Yes | Yes | |
| [Origin Rules](/rules/origin-rules/) | Yes | Yes | Enterprise zones can configure Origin Rules, by setting the Host Header and DNS Overrides to direct traffic to a SaaS zone. |
| [Page Shield](/page-shield/) | Yes | Yes | |
| [Polish](/images/polish/) | Yes\* | Yes | Polish only runs on cached assets. If the customer zone is bypassing cache for SaaS zone destined traffic, then images optimized by Polish will not be loaded from origin. |
Expand Down
2 changes: 1 addition & 1 deletion .../docs/fundamentals/reference/policies-compliances/content-security-policies.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ To use certain Cloudflare features, however, you may need to update the headers

| Feature(s) | Updated headers |
| --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Rocket Loader](/speed/optimization/content/rocket-loader/), [Mirage](/speed/optimization/images/mirage/) | `script-src 'self' ajax.cloudflare.com;` |
| [Rocket Loader](/speed/optimization/content/rocket-loader/) | `script-src 'self' ajax.cloudflare.com;` |
| [Scrape Shield](/waf/tools/scrape-shield/) | `script-src 'self' 'unsafe-inline'` |
| [Web Analytics](/web-analytics/) | `script-src static.cloudflareinsights.com; connect-src cloudflareinsights.com` |
| [Bot products](/bots/) | Refer to [JavaScript detections and CSPs](/cloudflare-challenges/challenge-types/javascript-detections/#if-you-have-a-content-security-policy-csp). |
Expand Down
24 changes: 0 additions & 24 deletions src/content/docs/rules/configuration-rules/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -152,30 +152,6 @@ API configuration property name: `"fonts"` (boolean).

</Details>

## Mirage

:::caution[Deprecation notice]
Mirage was deprecated on September 15, 2025.
:::

[Mirage](/speed/optimization/images/mirage/) accelerates image delivery for your visitors based on their device.

Use this setting to turn on or off Mirage for matching requests.

<Details header="API information">

API configuration property name: `"mirage"` (boolean).

```json title="API configuration example"
"action_parameters": {
"mirage": false
}
```

<Render file="configuration-rule-link-to-examples" product="rules" />

</Details>

## Opportunistic Encryption

[Opportunistic Encryption](/ssl/edge-certificates/additional-options/opportunistic-encryption/) allows browsers to access HTTP URIs over an encrypted TLS channel.
Expand Down
1 change: 0 additions & 1 deletion src/content/docs/rules/page-rules/reference/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,6 @@ The available Page Rules settings are the following:
| Forwarding URL | Redirects one URL to another using an `HTTP 301/302` redirect. Refer to [Wildcard matching and referencing](/rules/page-rules/reference/wildcard-matching/). | All |
| Host Header Override | Apply a specific host header.<Render file="origin-rule-promotion" product="rules" params={{ originRuleUrl: "/rules/origin-rules/features/#host-header" }} /> | Enterprise |
| IP Geolocation Header | Cloudflare adds a `CF-IPCountry` HTTP header containing the country code that corresponds to the visitor. | All |
| [Mirage](/speed/optimization/images/mirage/) | Turn on or off **Mirage** (deprecated).<Render file="configuration-rule-promotion" product="rules" /> | Pro and above |
| [Opportunistic Encryption](/ssl/edge-certificates/additional-options/opportunistic-encryption/) | Turn on or off the **Opportunistic Encryption**.<Render file="configuration-rule-promotion" product="rules" />  | All |
| [Origin Cache Control](/cache/concepts/cache-control/) | Origin Cache Control is enabled by default for Free, Pro, and Business domains and disabled by default for Enterprise domains. | All |
| Origin Error Page Pass-thru | Turn on or off Cloudflare error pages generated from issues sent from the origin server. If enabled, this setting triggers error pages issued by the origin. | Enterprise |
Expand Down
47 changes: 2 additions & 45 deletions src/content/docs/rules/reference/page-rules-migration.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,6 @@ Also, to streamline common configurations, the Cloudflare dashboard now includes
| Forwarding URL | Redirect Rules (Single Redirects) | [Migrate Forwarding URL](#migrate-forwarding-url) |
| Host Header Override | Origin Rules | [Migrate Host Header Override](#migrate-host-header-override) |
| IP Geolocation Header | Transform Rules (Managed Transforms) | [Migrate IP Geolocation Header](#migrate-ip-geolocation-header) |
| Mirage (deprecated) | Configuration Rules | [Migrate Mirage](#migrate-mirage) |
| Opportunistic Encryption | Configuration Rules | [Migrate Opportunistic Encryption](#migrate-opportunistic-encryption) |
| Origin Cache Control | Cache Rules | [Migrate Origin Cache Control](#migrate-origin-cache-control) |
| Origin Error Page Pass-thru | Cache Rules | [Migrate Origin Error Page Pass-thru](#migrate-origin-error-page-pass-thru) |
Expand Down Expand Up @@ -629,7 +628,7 @@ You configured a Page Rule turning off Cloudflare Apps (deprecated) for all subd
The **Disable Performance** setting is deprecated. Any Page Rules with this setting will not be migrated.
:::

This Page Rules setting turned off Mirage (deprecated), Polish, and Rocket Loader. You can still turn on or off relevant Cloudflare features one by one using Configuration Rules.
This Page Rules setting turned off Polish, and Rocket Loader. You can still turn on or off relevant Cloudflare features one by one using Configuration Rules.

<Tabs> <TabItem label="Dashboard">

Expand All @@ -644,15 +643,14 @@ You configured a Page Rule with **Disable Performance** (deprecated) for all sub

<Steps>

1. [Create a configuration rule](/rules/configuration-rules/create-dashboard/) to disable Mirage, Polish, and Rocket Loader for any hostname containing `example.com`:
1. [Create a configuration rule](/rules/configuration-rules/create-dashboard/) to disable Polish and Rocket Loader for any hostname containing `example.com`:

- **When incoming requests match**: Custom filter expression
- Using the Expression Builder:<br/>
`Hostname contains "example.com"`
- Using the Expression Editor:<br/>
`(http.host contains "example.com")`
- **Then the settings are**:
- **Mirage**: Off
- **Polish**: _Off_
- **Rocket Loader**: Off

Expand Down Expand Up @@ -1007,47 +1005,6 @@ You configured a Page Rule adding a `CF-IPCountry` HTTP header, for all requests

</TabItem> </Tabs>

### Migrate Mirage (deprecated) {/* migrate-mirage */}

<Tabs> <TabItem label="Dashboard">

**Context:**

You configured a Page Rule turning off Mirage (deprecated) for all subdomains of `example.com` and the `example.com` domain itself:

- **URL**: `*example.com/*`
- **Setting**: _Mirage_
- **Value**: Off

**How to migrate**:

<Steps>

1. [Create a configuration rule](/rules/configuration-rules/create-dashboard/) to turn off Mirage for any hostname containing `example.com`:

- **When incoming requests match**: Custom filter expression
- Using the Expression Builder:<br/>
`Hostname contains "example.com"`
- Using the Expression Editor:<br/>
`(http.host contains "example.com")`
- **Then the settings are**:
- **Setting**: Mirage
- **Value**: Off

2. Turn off your existing Page Rule and validate the behavior of the configuration rule you created.

3. If your tests succeed, delete the existing Page Rule.

</Steps>

</TabItem> <TabItem label="Visual guide">

| Page Rules configuration | Migrate to a configuration rule |
| -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![Example Page Rule with 'Mirage' setting](~/assets/images/rules/reference/page-rules-migration/pr-mirage.png) | ![Configuration rule matching the 'Mirage > Off' setting of the example Page Rule](~/assets/images/rules/reference/page-rules-migration/pr-mirage-new.png) |

</TabItem> </Tabs>

### Migrate Opportunistic Encryption

<Tabs> <TabItem label="Dashboard">
Expand Down
1 change: 0 additions & 1 deletion ...ent/docs/speed/optimization/content/troubleshooting/content-encoding-issues.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,6 @@ You also have the option to turn off these features site-wide within the dashboa

- [Email Obfuscation](/waf/tools/scrape-shield/email-address-obfuscation/), located in the **Scrape Shield** section.
- [Rocket Loader](/speed/optimization/content/rocket-loader/), located in **Speed** > **Optimization** > **Content Optimization** section.
- [Mirage](/speed/optimization/images/mirage/) (deprecated), located in **Speed** > **Optimization** > **Image Optimization**. section.
- [Automatic HTTPS Rewrites](/ssl/edge-certificates/additional-options/automatic-https-rewrites/), located in the **SSL/TLS** > **Edge Certificates** section.

Misconfiguring the `Content-Type` or charset within HTML, or leaving them unspecified can lead to unintended consequences. This can disrupt the intended content presentation, resulting in disorganized rendering and potentially unclear characters. Properly configuring these elements ensures consistent and accurate interpretation, correct HTML modifications, and accurate rendering for browsers. This creates a seamless user experience and aligns with best practices in web development.
Loading
Loading