Consolidate blurry screenshot FAQ into REST API docs (#26226)

kathayl · ToriLindsay · web-flow · commit c77d6ff9137a · 2025-11-03T19:24:47.000Z
* Consolidate blurry screenshot FAQ into REST API docs

- Create partial for blurry screenshot resolution content
- Add partial to screenshot endpoint and snapshot endpoint advanced usage sections
- Remove blurry screenshot FAQ entry from main FAQ page

* Update src/content/partials/browser-rendering/improve-blurry-screenshot-resolution.mdx

Co-authored-by: ToriLindsay &lt;tgalatro@cloudflare.com&gt;

---------

Co-authored-by: ToriLindsay &lt;tgalatro@cloudflare.com&gt;
diff --git a/src/content/docs/browser-rendering/faq.mdx b/src/content/docs/browser-rendering/faq.mdx
@@ -54,10 +54,6 @@ There is no fixed limit on the number of requests per browser session. A single
 
 This error typically occurs because your Puppeteer launch is not receiving the Browser binding. To resolve: Pass your Browser binding into `puppeteer.launch`.
 
-### Why is my screenshot blurry?
-
-It may be because you increased the height and width of the viewport. To fix this, increase the value of the `deviceScaleFactor` (default is 1).
-
 ### `Error processing the request: Unable to create new browser: code: 429: message: Browser time limit exceeded for today`
 
 This error indicates you have hit the daily browser-instance limit on the Workers Free plan. [Free-plan accounts are capped at free plan limit is 10 minutes of browser use a day](/browser-rendering/platform/limits/#workers-free) once you exceed those, further creation attempts return a 429 until the next UTC day.
diff --git a/src/content/docs/browser-rendering/rest-api/screenshot-endpoint.mdx b/src/content/docs/browser-rendering/rest-api/screenshot-endpoint.mdx
@@ -135,6 +135,11 @@ curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-
   --output "advanced-screenshot.png"
 ```
 
+<Render
+  file="improve-blurry-screenshot-resolution"
+  product="browser-rendering"
+/>
+
 ### Customize CSS and embed custom JavaScript
 
 Instruct the browser to go to `https://example.com`, embed custom JavaScript (`addScriptTag`) and add extra styles (`addStyleTag`), both inline (`addStyleTag.content`) and by loading an external stylesheet (`addStyleTag.url`).
diff --git a/src/content/docs/browser-rendering/rest-api/snapshot.mdx b/src/content/docs/browser-rendering/rest-api/snapshot.mdx
@@ -127,6 +127,12 @@ curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-
 	}
 }
 ```
+
+<Render
+  file="improve-blurry-screenshot-resolution"
+  product="browser-rendering"
+/>
+
 <Render
   file="setting-custom-user-agent"
   product="browser-rendering"
diff --git a/src/content/partials/browser-rendering/improve-blurry-screenshot-resolution.mdx b/src/content/partials/browser-rendering/improve-blurry-screenshot-resolution.mdx
@@ -0,0 +1,15 @@
+### Improve blurry screenshot resolution
+
+If you set a large viewport width and height, your screenshot may appear blurry or pixelated. This can happen if your browser's default `deviceScaleFactor` (which defaults to 1) is not high enough for the viewport.
+
+To fix this, increase the value of the `deviceScaleFactor`.
+```json
+{
+  "url": "https://cloudflare.com/",
+  "viewport": {
+    "width": 3600,
+    "height": 2400,
+    "deviceScaleFactor": 2
+  }
+}
+```

Original file line number	Diff line number	Diff line change
`@@ -127,6 +127,12 @@ curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-`
`127`	`127`	`}`
`128`	`128`	`}`
`129`	`129`	```
	`130`	`+`
	`131`	`+<Render`
	`132`	`+ file="improve-blurry-screenshot-resolution"`
	`133`	`+ product="browser-rendering"`
	`134`	`+/>`
	`135`	`+`
`130`	`136`	`<Render`
`131`	`137`	`file="setting-custom-user-agent"`
`132`	`138`	`product="browser-rendering"`