---
title: "fullpage parameter"
description: "Capture the entire scroll height of a page in one image with the html2img API."
url: "https://html2img.com/docs/parameters/fullpage/"
---

# Fullpage Parameter

The `fullpage` parameter allows you to capture the entire page height, regardless of the viewport height setting.

> **Note**
>
> `fullpage` has no effect when [`format`](https://html2img.com/docs/parameters/format/) is `pdf`: long content paginates across A4 pages automatically.

## Specifications

| Property | Value |
|----------|-------|
| Type | boolean |
| Required | No |
| Default | false |
| API | Both HTML/CSS and Screenshot APIs |

## Description

When `fullpage` is set to `true`:
- The entire page height will be captured
- The viewport width will still be respected
- Scrollable content will be included in the capture
- The final image height will match the content height

> **Important**
>
> For pages with dynamic content or infinite scroll, we recommend setting a reasonable max-height on your content to prevent timeouts.

> **Warning**
>
> When setting `fullpage` to `true` the DPI value will be forced to `1`. If you need a larger DPI then set explicit `width` and `height` instead.

## Examples

### Basic Fullpage Screenshot
```json
{
    "url": "https://example.com",
    "fullpage": true
}
```

### HTML with Long Content
```json
{
    "html": "<div style='height: 2000px'>Long scrolling content</div>",
    "fullpage": true,
    "width": 1440
}
```

### Combining with Webhook
```json
{
    "url": "https://example.com",
    "fullpage": true,
    "webhook_url": "https://your-domain.com/webhook"
}
```

> **Warning**
>
> Full page captures may take longer to process, especially for long pages. We recommend using the `webhook_url` parameter for these requests.

## Common Use Cases

1. **Landing Page Captures**
 - Capture entire marketing pages
 - Include all sections in one image

2. **Content Archives**
 - Save full articles or blog posts
 - Archive entire web pages

3. **Portfolio Screenshots**
 - Capture entire project pages
 - Show full design implementations

> **Note**
>
> Use CSS to set a max-height on infinite scroll containers or dynamic content so captures stay predictable.

## Common values

- **`true`** - capture the entire scroll height. Use with [webhook_url](https://html2img.com/docs/parameters/webhook-url/) for long pages.
- **`false`** (default) - capture only the visible viewport defined by `width` and `height`.

## When to use

Use `fullpage: true` when you want every section of a page in one image, like a landing page archive or a portfolio screenshot. Use the default for fixed-size outputs like OG images, social cards or product cards where the dimensions are part of the spec.

## Common mistakes

- **Pairing with high DPI.** When `fullpage` is true, DPI is forced to 1. Set explicit `width` and `height` if you need higher DPI.
- **Capturing infinite-scroll pages.** Pages that lazy-load forever will time out. Inject CSS to set a max-height on scroll containers or capture a specific section with [selector](https://html2img.com/docs/parameters/selector/).

See also: [getting started guide](https://html2img.com/docs/getting-started/), [webhook_url](https://html2img.com/docs/parameters/webhook-url/).

## Templates that use this parameter

Long-form templates pair well with full-page capture when used as part of a wider scroll-through layout:

- [Blog hero image template](https://html2img.com/templates/blog-hero/)
- [Real estate listing template](https://html2img.com/templates/real-estate-listing/)