How to Screenshot a Django Admin Panel in Python

Django's built-in admin is often the fastest way internal teams get a usable interface to their own data, and it stays in use long after a project has a public-facing frontend too. That makes it a common target for screenshots — documentation for new hires, QA after a model or admin customization change, or a visual record of what a record looked like at a point in time.

Why the Admin Panel Has Its Own Quirks

• List views paginate and filter. A capture of a filtered or paginated list should point at the exact URL with query parameters, not just the base admin path.
• Inline forms and related-object widgets can be long, so a full-page capture is usually more useful than a cropped viewport.
• Custom admin CSS or JS varies by project, so a screenshot taken right after a theme change is a good way to confirm nothing broke.

Python Example

import requests

response = requests.post(
    "https://api.prod.ss.snapshot-site.com/api/v1/screenshot",
    headers={
        "Content-Type": "application/json",
        "x-snapshotsiteapi-key": "YOUR_API_KEY",
    },
    json={
        "url": "https://internal.example.com/admin/orders/order/",
        "format": "png",
        "width": 1440,
        "height": 900,
        "fullSize": True,
        "hideCookie": True,
    },
)

print(response.json())

Point the request at an authenticated session URL the same way as any other login-protected screen — see How to Screenshot a Login-Protected SaaS App for the general pattern, which applies to Django's session-based admin auth the same way.

Practical Recommendations

• Capture the exact filtered/paginated URL, not just the list view's default state, when the point is documenting a specific view.
• Default to fullSize: true for record detail pages with inline related-object forms — these are usually longer than a single screen.
• Use delay if the admin has custom JS widgets (date pickers, autocomplete fields) that render slightly after the initial page load.

Common Use Cases

• Internal documentation for new team members learning the admin
• QA screenshots after a Django or admin-theme upgrade
• Dated records of a specific object's state for support or audit purposes
• Regression checks on custom admin actions and inline forms

If you're not sure whether a plain capture or v2's cleanup options fit a heavily customized admin theme better, see Snapshot API v1 vs v2 vs v3: Which Endpoint Should You Use?.

Snapshot Site renders the admin the same way a logged-in staff user's browser would, without adding a browser dependency to your Django project.