Skip to content

Commit 41dfc80

Browse files
committed
fix up nav and also tweak titles on changelog entries
1 parent 53cf8f7 commit 41dfc80

4 files changed

Lines changed: 23 additions & 18 deletions

File tree

‎src/content/docs/changelog/2026_09_22__clarified-disable_twemoji-behavior-for-url-images.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Clarified `disable_twemoji` behavior for URL images"
2+
title: "Clarified disable_twemoji behavior for URL images"
33
slug: changelog/2026-09-22-clarified-disable-twemoji-behavior-for-url-images
44
description: "URL images only receive Twemoji when disable_twemoji is explicitly false; HTML/CSS images still default to false."
55
section: Changelog

‎src/content/docs/changelog/2026_09_29__block-browser-requests-with-request_overrides.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Block browser requests with `request_overrides`"
2+
title: "Block browser requests with request_overrides"
33
slug: changelog/2026-09-29-block-browser-requests-with-request-overrides
44
description: "Block selected scripts, images, and other browser requests while rendering images or templates."
55
section: Changelog

‎src/content/docs/parameters/request_overrides.mdx‎

Lines changed: 20 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -10,17 +10,7 @@ import Help from '../../../components/Help.astro';
1010

1111
Use `request_overrides` to stop selected network requests while Chrome renders an image. For example, you can prevent a third-party script or image from loading in a screenshot.
1212

13-
## When it's useful
14-
15-
A page can make requests that add nothing to the image you want to capture. Blocking those requests can help you:
16-
17-
- **Spend less time and bandwidth loading assets you won't show.** If a screenshot doesn't need a video or a set of decorative images from your CDN, Chrome doesn't need to download them for that render.
18-
- **Avoid sending screenshot visits to analytics services.** Block tracking beacons or scripts when you don't want automated renders counted alongside real visitors.
19-
- **Keep screenshots more consistent.** Third-party chat widgets, ads, and other extras can change or fail independently of your page. Block them when they aren't part of the image.
20-
21-
Only block resources your screenshot can do without. Blocking a font, stylesheet, script, or visible image may change the result.
22-
23-
## Block rules
13+
## How it works
2414

2515
Pass an array of rules. Each rule currently supports the `block` action and must have a `url` pattern, a `resource_types` array, or both:
2616

@@ -43,7 +33,23 @@ Pass an array of rules. Each rule currently supports the `block` action and must
4333

4434
When a rule has both `url` and `resource_types`, **both must match**. A request is blocked when **any** rule matches. A rule with only `resource_types` applies to matching requests from any URL. Blocking a `document` request can prevent the target page or an embedded frame from loading.
4535

46-
## More examples
36+
<Aside title="Availability">
37+
Request overrides require a paid plan. They work with URL screenshots, HTML/CSS images, and templates. An omitted value, `null`, or an empty array adds no overrides.
38+
</Aside>
39+
40+
## When to use it
41+
42+
A page can make requests that add nothing to the image you want to capture. Blocking those requests can help you:
43+
44+
- **Spend less time and bandwidth loading assets you won't show.** If a screenshot doesn't need a video or a set of decorative images from your CDN, Chrome doesn't need to download them for that render.
45+
- **Avoid sending screenshot visits to analytics services.** Block tracking beacons or scripts when you don't want automated renders counted alongside real visitors.
46+
- **Keep screenshots more consistent.** Third-party chat widgets, ads, and other extras can change or fail independently of your page. Block them when they aren't part of the image.
47+
48+
Only block resources your screenshot can do without. Blocking a font, stylesheet, script, or visible image may change the result.
49+
50+
## Example usage
51+
52+
### Block tracking and chat widgets
4753

4854
To leave tracking beacons and a third-party chat widget out of a screenshot, use two rules. The first matches `beacon` requests from any URL; the second matches every request to the widget host:
4955

@@ -56,6 +62,8 @@ To leave tracking beacons and a third-party chat widget out of a screenshot, use
5662
}
5763
```
5864

65+
### Skip unused CDN images
66+
5967
If your page references CDN images that aren't needed in the finished screenshot, block only that asset path. Other images on the page can still load:
6068

6169
```json
@@ -70,10 +78,6 @@ If your page references CDN images that aren't needed in the finished screenshot
7078
}
7179
```
7280

73-
<Aside title="Availability">
74-
Request overrides require a paid plan. They work with URL screenshots, HTML/CSS images, and templates. An omitted value, `null`, or an empty array adds no overrides.
75-
</Aside>
76-
7781
## Request formats
7882

7983
In a JSON image request, pass `request_overrides` as an array, as shown above. In an `application/x-www-form-urlencoded` request, send the entire array as one JSON-encoded field:

‎src/navigation.mjs‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,7 @@ const navigation = [
4848
{ label: 'pdf_options', link: '/parameters/pdf_options/' },
4949
{ label: 'proxy_id', link: '/parameters/proxy_id/' },
5050
{ label: 'render_when_ready', link: '/parameters/render_when_ready/' },
51+
{ label: 'request_overrides', link: '/parameters/request_overrides/' },
5152
{ label: 'selector', link: '/parameters/selector/' },
5253
{ label: 'storage_destination_id', link: '/parameters/storage_destination_id/' },
5354
{ label: 'timezone', link: '/parameters/timezone/' },

0 commit comments

Comments
 (0)