cookie banners

Author: mscoutermarsh

_includes/additional_parameters.md

@@ -6,5 +6,6 @@
 | **device_scale**   | `Double` | Controls the image resolution by adjusting the pixel ratio. Minimum: `1`, Maximum: `3`. Higher values increase image quality and file size. For example, `2` will double the resolution. [Learn more](/parameters/device_scale/). |
 | **render_when_ready**   | `Boolean` | Set to true to control when the image is generated. Call `ScreenshotReady()` from JavaScript to generate the image. [Learn more](/parameters/render_when_ready/). |
 | **full_screen**   | `Boolean` | When set to true, the API will generate an image of the entire height of the page. |
+| **block_consent_banners**   | `Boolean` | When set to `true`, automatically blocks cookie consent banners and popups on websites. Most useful for URL screenshots. |
 | **viewport_width**   | `Integer` | Set the width of Chrome's viewport. This will disable automatic cropping. Both height and width parameters must be set if using either. |
 | **viewport_height**   | `Integer` | Set the height of Chrome's viewport. This will disable automatic cropping. Both height and width parameters must be set if using either. | 

changelog.md

@@ -16,6 +16,18 @@ Always improving. Updates to HTML/CSS to Image are posted here.
 
 If you have feature requests, please send them to us: [email protected].
 
+### Automatic cookie consent banner blocking
+June 18, 2025
+{: .text-delta}
+
+We've added a new `block_consent_banners` parameter that automatically blocks cookie consent popups and banners on websites. When set to `true`, the API will detect and hide common consent frameworks like OneTrust, Cookiebot, Quantcast Choice, TrustArc, and many others.
+
+This feature is especially useful for URL screenshots where cookie banners can interfere with the desired content. Instead of manually writing CSS to hide specific banners, you can now use this single parameter to handle most cases automatically.
+
+The automatic blocking is maintained and updated regularly to support new consent frameworks as they emerge. For custom implementations not covered by the automatic blocking, you can still use the existing CSS injection method.
+
+<hr>
+
 ### Single-Request Image Generation endpoint
 June 15, 2025
 {: .text-delta}

getting-started/url-to-image.md

@@ -75,6 +75,20 @@ To learn about CSS Selectors, we recommend [this article](https://www.w3schools.
 
 <hr>
 
+## Blocking cookie consent banners
+
+Many websites display cookie consent popups that can interfere with your screenshots. Use the `block_consent_banners` parameter to automatically hide these:
+
+```bash
+curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey' \
+     --data-urlencode url="https://example.com" \
+     --data block_consent_banners=true
+```
+
+This automatically detects and blocks common consent frameworks like OneTrust, Cookiebot, and others. For more advanced cases, see our [complete guide to blocking cookie banners](/guides/blocking-cookie-banners/).
+
+<hr>
+
 ## Pages requiring login or sign-in
 
 Our API does not support pages that require login. The URL must be publicly accessible for us to generate an image of it.

guides/blocking-cookie-banners.md

@@ -18,7 +18,34 @@ Learn how to block cookie banners with taking screenshots
 
 ## How it works
 
-The easiest way to hide cookie banners in your screenshots is by injecting CSS into your image to hide them.
+The easiest way to hide cookie banners in your screenshots is by using the `block_consent_banners` parameter.
+
+When set to `true`, the API will automatically detect and block common cookie consent banners and popups on websites. This is the recommended approach for most use cases.
+
+## Automatic Cookie Banner Blocking
+
+Simply add `block_consent_banners: true` to your API request:
+
+```json
+{
+  "url": "https://example.com",
+  "block_consent_banners": true
+}
+```
+
+This automatically handles the most common cookie consent frameworks including:
+- OneTrust
+- Cookiebot
+- Quantcast Choice
+- TrustArc
+- Osano
+- And many others
+
+{% include hint.md title="Recommended Method" text="Using block_consent_banners is the easiest and most reliable way to hide cookie popups. It's maintained and updated regularly to handle new consent frameworks." %}
+
+## Manual CSS Injection (Advanced)
+
+For custom cookie banners not covered by the automatic blocking, you can still use CSS injection.
 
 Any CSS passed via the `css` param when generating a URL image will get injected into the page.