Skip to content

[Docs] Mirage deprecation follow-up #24199

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

Draft
wants to merge 1 commit into
base: production
Choose a base branch
from
+20 −18
Draft

[Docs] Mirage deprecation follow-up #24199

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
2 changes: 1 addition & 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,7 @@ 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/)
* [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
4 changes: 2 additions & 2 deletions ...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,7 @@ 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/) | Yes | Yes | |
| [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 All @@ -49,6 +49,6 @@ This is not an exhaustive list of Cloudflare products and features.
| [WAF custom rules](/waf/custom-rules/) | Yes | Yes | WAF custom rules that match the subdomain used for O2O may block or interfere with the flow of visitors to your website. |
| [WAF managed rules](/waf/managed-rules/) | Yes | Yes | |
| [Waiting Room](/waiting-room/) | Yes | Yes | |
| [Websockets](/network/websockets/) | No | No | |
| [WebSockets](/network/websockets/) | No | No | |
| [Workers](/workers/) | Yes\* | Yes | Similar to Page Rules, Workers that match the subdomain used for O2O may block or interfere with the flow of visitors to your website. |
| [Zaraz](/zaraz/) | Yes | No | |
2 changes: 1 addition & 1 deletion 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 @@ -156,7 +156,7 @@ API configuration property name: `"fonts"` (boolean).

## Mirage

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

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

Expand Down
2 changes: 1 addition & 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 @@ -41,7 +41,7 @@ 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**.<Render file="configuration-rule-promotion" product="rules" /> | Pro and above |
| [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
8 changes: 4 additions & 4 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,7 @@ 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 | Configuration Rules | [Migrate Mirage](#migrate-mirage) |
| 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 @@ -653,7 +653,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, 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 Mirage (deprecated), 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 Down Expand Up @@ -1038,13 +1038,13 @@ You configured a Page Rule adding a `CF-IPCountry` HTTP header, for all requests

</TabItem> </Tabs>

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

<Tabs> <TabItem label="Dashboard">

**Context:**

You configured a Page Rule turning off Mirage for all subdomains of `example.com` and the `example.com` domain itself:
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_
Expand Down
2 changes: 1 addition & 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,7 @@ 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/), located in **Speed** > **Optimization** > **Image 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.
4 changes: 3 additions & 1 deletion src/content/docs/speed/optimization/images/mirage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,9 @@ learning_center:
link: https://www.cloudflare.com/learning/performance/what-is-lazy-loading/
sidebar:
order: 3

label: Mirage
badge:
text: Deprecated
---

import { FeatureTable, GlossaryTooltip, Render } from "~/components"
Expand Down
2 changes: 1 addition & 1 deletion ...cs/speed/optimization/images/troubleshooting/troubleshooting-missing-images.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ To troubleshoot:
* [Purge cache](/cache/how-to/purge-cache) for the URL of the missing image file.
* [Temporarily pause Cloudflare](/fundamentals/manage-domains/pause-cloudflare/).
* Disable [Rocket Loader](/speed/optimization/content/rocket-loader/enable/).
* Disable [Mirage](/speed/optimization/images/mirage/#enable-mirage).
* Disable [Mirage](/speed/optimization/images/mirage/#enable-mirage) (deprecated).
2. Retest the image load in a private browser tab.
3. If the issue is not fixed, try another of the actions suggested in Step 1.
Loading