How agent-ready is Netlify?
Independent agentability audit of Netlify, scored across the 8 principles of Agent Factors Engineering — how well AI agents can parse, navigate, and operate it.
Audit summary
Netlify's agentability audit shows a mixed readiness for autonomous AI interaction. The homepage scored 34/100, with pricing at 50/100 and documentation at 47/100. These scores indicate that while human users can navigate the platform effectively, AI agents face significant barriers when attempting to parse outcomes, understand system state, or recover from errors.
The platform performs adequately on machine readability (74/100) and control (72/100), meaning agents can generally consume structured data and issue commands. However, Netlify scores poorly on transparency (0/100), clean handoffs (0/100), and shadow UI avoidance (15/100). These gaps mean agents cannot trace why the system produced a given result, lack structured error context when operations fail, and struggle with UI elements that are not exposed through accessible patterns.
The low status score (30/100) and defaults score (35/100) further indicate that agents receive insufficient feedback during long-running operations and must frequently make guesses about reasonable starting values. Improving these areas would significantly enhance Netlify's ability to serve as a backend for AI-driven workflows and autonomous deployment agents.
Score by principle
Key findings
How Netlify could improve its score
Netlify can improve its agentability by addressing the following issues identified in the audit:
- Expose an activity or audit log in machine-readable form (JSON event log) alongside a visible activity feed, so agents can trace system actions and understand decision history.
- Return structured error context on failures—including what failed, the error code, and the offending field—in both UI and API responses, rather than generic messages like 'Something went wrong'.
- Emit descriptive status text during asynchronous operations (e.g., 'Uploading 3 of 10 files') and use enumerated multi-step progress indicators for long tasks instead of bare spinners.
- Surface confidence or certainty metadata on key outputs, such as a confidence field in API responses or 'verified vs best-guess' labels in the UI.
- Add JSON-LD structured data (schema.org) to key pages to describe primary entities like products, pricing plans, and documentation topics.
- Attach source references or input citations (links or identifiers) to generated outputs and provide one-line summaries with expandable drill-downs for important results.
Work at Netlify? Re-audit any page free.
Scores refresh automatically when we re-crawl — or run an instant audit on any URL now.
Run a free auditEmbed this score
Show your agent-readiness in your docs or README. The badge links back to this live report.