Divitis is a web development anti-pattern where authors rely solely on the generic <div> and <span> elements—which carry no intrinsic semantic meaning—instead of using appropriate semantic HTML elements like <nav>, <article>, <section>, or <aside>. This practice creates a flat DOM structure devoid of programmatic determinism, forcing AI parsers and search engine crawlers to guess at content hierarchy and relationships rather than extracting them from explicit, machine-readable landmarks.
Glossary
Divitis

What is Divitis?
A colloquial term describing the excessive and exclusive use of semantically neutral <div> and <span> elements to structure an HTML document, resulting in a flat, meaningless document outline that hinders AI content extraction and accessibility.
The primary consequence of divitis is severely degraded semantic extraction, as AI models cannot reliably identify content categories, heading hierarchies, or landmark regions within a document composed entirely of neutral containers. This anti-pattern directly undermines generative engine optimization by obscuring entity relationships and factual grounding signals, making it impossible for retrieval-augmented generation systems to confidently cite or summarize the content.
Core Characteristics of Divitis
Divitis is a colloquial anti-pattern describing the excessive and exclusive use of semantically neutral <div> and <span> elements, resulting in a flat, meaningless document structure that hinders AI content extraction and accessibility.
Semantic Flatness
The defining characteristic of Divitis is a document object model (DOM) composed almost entirely of <div> and <span> elements. These elements are inherently semantically neutral—they convey no programmatic meaning about the content they contain. An AI parser encountering a page built with Divitis cannot distinguish a navigation landmark from an article body or a footer, as every structural block is an identical, meaningless container. This forces extraction algorithms to rely on fragile, class-name-based heuristics rather than the robust, standardized accessibility tree.
Class-Name Dependency
To compensate for the lack of native semantics, developers with Divitis rely entirely on CSS class names (e.g., class="header", class="article") to convey meaning. This approach is fundamentally brittle because:
- Class names are not standardized and vary wildly between projects and teams.
- AI crawlers and search engines do not parse CSS class names as reliable semantic signals.
- The meaning is only apparent to human developers reading the source code, not to machines. This creates a semantic gap between developer intent and machine interpretation.
Accessibility Tree Degradation
The browser constructs an accessibility tree from the DOM to expose content to assistive technologies and programmatic agents. Divitis starves this tree of meaningful roles. Without elements like <nav>, <main>, <article>, or <aside>, the accessibility tree becomes a monolithic block of generic containers. Screen readers lose the ability to offer landmark navigation, and AI agents cannot efficiently skip to relevant content regions. Remediation requires manually patching every <div> with ARIA roles (e.g., role="navigation"), which duplicates the function of native HTML elements.
Heading Hierarchy Collapse
Divitis often correlates with a broken or non-existent heading hierarchy. When all content is wrapped in <div> elements, developers may use visual styling (bold, larger font-size) to simulate headings rather than using <h1> through <h6> elements. This practice is catastrophic for AI content extraction because:
- Heading elements are the primary mechanism for AI models to understand document outline and content importance.
- Without a proper hierarchy, the document appears as an undifferentiated wall of text.
- Retrieval-augmented generation (RAG) systems rely on heading structure for accurate chunking and retrieval.
Remediation: First Normal Form
The cure for Divitis is achieving First Normal Form (1NF) for the DOM, a concept borrowed from database normalization. This involves replacing generic <div> elements with the correct semantic HTML5 equivalents:
<div class="header">→<header><div class="nav">→<nav><div class="content">→<main><div class="post">→<article><div class="sidebar">→<aside><div class="footer">→<footer>This transformation provides programmatic determinism, ensuring AI agents and accessibility tools can reliably interpret document structure.
Impact on Generative Engine Optimization
Divitis directly undermines Generative Engine Optimization (GEO) efforts. AI models constructing answers from retrieved content prioritize documents with clear, machine-parseable structure. A page suffering from Divitis presents a low signal-to-noise ratio to AI crawlers, as every content block appears structurally identical. This reduces the likelihood of:
- Accurate entity extraction for knowledge graph injection.
- Successful semantic chunking for RAG system retrieval.
- High-confidence citation in AI-generated overviews. The absence of semantic landmarks makes it difficult for answer engines to isolate and cite specific facts from the page.
Frequently Asked Questions
Clear, technical answers to the most common questions about the semantic anti-pattern of excessive <div> and <span> usage.
Divitis is a colloquial anti-pattern describing the excessive and exclusive use of semantically neutral <div> and <span> elements to structure an entire HTML document, resulting in a flat, meaningless DOM structure. It is a problem for AI because these elements carry zero native semantics; a <div> conveys no information about its role, content type, or relationship to other nodes. When an AI parser or Retrieval-Augmented Generation (RAG) system encounters a document riddled with Divitis, it cannot programmatically distinguish a navigation block from an article body, a footer, or an aside. This forces the model to rely solely on visual heuristics or fragile class name guessing, dramatically reducing semantic extraction accuracy and increasing the risk of misattributed facts or hallucinated summaries. The document becomes an undifferentiated soup of text, stripping the AI of the structural context it needs for confident entity disambiguation and factual grounding.
Enabling Efficiency, Speed & Accuracy
Intelligent Analysis, Decision & Execution
We build AI systems for teams that need search across company data, workflow automation across tools, or AI features inside products and internal software.
Talk to Us
Search across company data
Give teams answers from docs, tickets, runbooks, and product data with sources and permissions.
Useful when people spend too long searching or get different answers from different systems.

Automate internal workflows
Use AI to route work, draft outputs, trigger actions, and keep approvals and logs in place.
Useful when repetitive work moves across multiple tools and teams.

Add AI to products and internal tools
Build assistants, guided actions, or decision support into the software your team or customers already use.
Useful when AI needs to be part of the product, not a separate tool.
Related Terms
Understanding Divitis requires familiarity with the semantic alternatives and structural concepts that define proper document architecture for AI parsers and accessibility bots.
Semantic HTML
The direct antidote to Divitis. Semantic HTML uses elements according to their intrinsic, programmatically determined meaning rather than for visual presentation alone. Elements like <article>, <nav>, <aside>, and <section> explicitly communicate content roles to AI parsers, enabling accurate extraction of document structure. Unlike <div>, which conveys zero semantic value, semantic elements populate the accessibility tree with meaningful roles, states, and properties that both assistive technologies and generative engines rely on for content interpretation.
Heading Hierarchy
A logical, nested structure of <h1> through <h6> elements that defines the document outline. Proper heading hierarchy communicates the relative importance and parent-child relationships of content sections to search engine parsers and accessibility bots. Divitis often manifests as using styled <div> or <span> elements instead of actual heading tags, which renders the document outline invisible to AI crawlers. A well-structured heading tree is one of the strongest signals for information architecture that generative engines use to understand content scope.
ARIA Landmarks
A set of predefined roles—banner, navigation, main, complementary, contentinfo—added to HTML elements to programmatically identify distinct page regions. When developers suffer from Divitis, they wrap everything in generic <div> containers, forcing them to manually apply ARIA roles to restore lost semantics. Native semantic elements like <header>, <nav>, and <footer> have implicit ARIA landmark roles, eliminating the need for redundant role attributes and ensuring AI agents can efficiently navigate document structure without ambiguity.
Accessibility Tree
A parallel structure generated by the browser from the DOM that exposes semantic information, properties, and relationships exclusively to assistive technologies and programmatic agents. Divitis produces a flat, undifferentiated accessibility tree where every node is a generic container with no meaningful role. This forces screen readers and AI parsers to guess at content relationships. Semantic HTML elements automatically populate the accessibility tree with correct roles—<main> becomes a landmark, <button> becomes an interactive control—creating a rich, navigable structure for machine interpretation.
Programmatic Determinism
The principle that the meaning, state, and value of a user interface component can be reliably interpreted by software, including AI agents, through standardized, machine-readable properties. Divitis violates this principle by replacing semantically deterministic elements with neutral containers. A <div onclick='submit()'> is not programmatically a button—it lacks the implicit role, keyboard interactivity, and accessible name computation that a <button> provides. For AI-driven search engines, programmatic determinism ensures content structure is unambiguous and extractable.
Content Categories
The formal groupings defined by the HTML specification—Flow, Phrasing, Sectioning, Heading, Embedded, Interactive, Metadata—that dictate where an element can be used and what its semantic purpose is. Divitis ignores these categories entirely, treating <div> as a universal container. Understanding content categories helps developers select the correct element: sectioning content (<article>, <aside>, <nav>, <section>) defines the document outline, while heading content defines section labels. AI parsers rely on these categorical distinctions to build accurate document models.

About the author
Prasad Kumkar
CEO & MD, Inference Systems
Prasad Kumkar is the CEO & MD of Inference Systems and writes about AI systems architecture, LLM infrastructure, model serving, evaluation, and production deployment. Over 5+ years, he has worked across computer vision models, L5 autonomous vehicle systems, and LLM research, with a focus on taking complex AI ideas into real-world engineering systems.
His work and writing cover AI systems, large language models, AI agents, multimodal systems, autonomous systems, inference optimization, RAG, evaluation, and production AI engineering.
Partnered with leading AI, data, and software stack.
How We Work
Custom AI workflows for your Business
One-fit-all AI don't work for modern businesses. At Inferensys, we aim to understand your business & custom requirements; which we use to define most efficient agentic workflows, the data, and the tools for your business.
01
Review the use case
We understand the task, the users, and where AI can actually help.
Read more02
Pick the right approach
We define what needs search, automation, or product integration.
Read more03
Build the first useful version
We implement the part that proves the value first.
Read more04
Improve from there
We add the checks and visibility needed to keep it useful.
Read moreThe first call is a practical review of your use case and the right next step.
Talk to Us