ms_delay

Adjust rendering delay to capture dynamic content

When content is missing from your screenshots, the ms_delay parameter lets you add a delay before capture. This can help with:

• JavaScript that needs time to execute
• Assets (images, fonts) still loading
• Animations not completing
• Dynamic content not appearing

The ms_delay parameter should only be used when:

1. Your screenshots are missing expected content
2. Dynamic content isn’t appearing in the final image
3. Custom fonts or images aren’t loading properly

By default, the API intelligently handles most loading scenarios:

• Waits for the page to fully load
• Detects when assets finish loading
• Automatically manages common JavaScript frameworks

Only add ms_delay if you notice issues with the default behavior.

The ms_delay parameter can affect how many image credits are consumed per request:

• Maximum allowed value is 20,000ms (20 seconds)
• Values are rounded up to the nearest image credit tier
• Image credits are calculated before the request is processed

// Standard usage (1 image credit)
{
  "html": "<div>Your content</div>",
  "ms_delay": 3000
}

// 2 image credits used
{
  "html": "<div>Your content</div>",
  "ms_delay": 8000
}

// 4 image credits used (maximum)
{
  "html": "<div>Your content</div>",
  "ms_delay": 20000
}

Instead of using high ms_delay values, consider:

1. Using the render_when_ready parameter
2. Optimizing your page load time
3. Preloading assets
4. Reducing JavaScript execution time

This can help reduce both image credit usage and overall processing time.