var Component=(()=>{var p=Object.create;var l=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var b=Object.getPrototypeOf,g=Object.prototype.hasOwnProperty;var f=(i,n)=>()=>(n||i((n={exports:{}}).exports,n),n.exports),k=(i,n)=>{for(var r in n)l(i,r,{get:n[r],enumerable:!0})},a=(i,n,r,c)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of u(n))!g.call(i,t)&&t!==r&&l(i,t,{get:()=>n[t],enumerable:!(c=m(n,t))||c.enumerable});return i};var y=(i,n,r)=>(r=i!=null?p(b(i)):{},a(n||!i||!i.__esModule?l(r,"default",{value:i,enumerable:!0}):r,i)),x=i=>a(l({},"__esModule",{value:!0}),i);var o=f((N,d)=>{d.exports=_jsx_runtime});var P={};k(P,{default:()=>h,frontmatter:()=>w});var e=y(o()),w={title:"How do Webmentions differ from Pingbacks?",description:"Understanding the key differences between Webmentions and the older Pingback protocol.",category:"basics",order:3,published:!0};function s(i){let n={a:"a",code:"code",h2:"h2",h3:"h3",li:"li",ol:"ol",p:"p",pre:"pre",span:"span",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...i.components};return(0,e.jsxs)(e.Fragment,{children:[(0,e.jsx)(n.p,{children:"While Webmentions and Pingbacks serve similar purposes\u2014notifying websites when they've been linked to\u2014Webmentions are a modern replacement that fixes many of Pingback's limitations."}),` `,(0,e.jsxs)(n.h2,{id:"key-differences",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#key-differences",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Key Differences"]}),` `,(0,e.jsxs)(n.h3,{id:"protocol-simplicity",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#protocol-simplicity",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Protocol Simplicity"]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Pingbacks:"})}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"Use XML-RPC, a complex protocol"}),` `,(0,e.jsx)(n.li,{children:"Require XML parsing libraries"}),` `,(0,e.jsx)(n.li,{children:"More prone to implementation errors"}),` `,(0,e.jsx)(n.li,{children:"Difficult to debug"}),` `]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Webmentions:"})}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"Use simple HTTP POST requests"}),` `,(0,e.jsx)(n.li,{children:"Send data as form-encoded parameters"}),` `,(0,e.jsx)(n.li,{children:"Easy to implement and test"}),` `,(0,e.jsx)(n.li,{children:"Human-readable and debuggable"}),` `]}),` `,(0,e.jsxs)(n.h3,{id:"verification-process",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#verification-process",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Verification Process"]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Pingbacks:"})}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"Limited verification"}),` `,(0,e.jsx)(n.li,{children:"Only confirms the link exists"}),` `,(0,e.jsx)(n.li,{children:"Can't extract context or metadata"}),` `,(0,e.jsx)(n.li,{children:"Prone to spam"}),` `]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Webmentions:"})}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"Flexible verification"}),` `,(0,e.jsx)(n.li,{children:"Can parse rich metadata via microformats"}),` `,(0,e.jsx)(n.li,{children:"Supports different interaction types (likes, replies, etc.)"}),` `,(0,e.jsx)(n.li,{children:"Better spam prevention options"}),` `]}),` `,(0,e.jsxs)(n.h3,{id:"security",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#security",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Security"]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Pingbacks:"})}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"XML-RPC endpoint can be exploited"}),` `,(0,e.jsx)(n.li,{children:"Often used in DDoS attacks"}),` `,(0,e.jsx)(n.li,{children:"Limited rate limiting options"}),` `,(0,e.jsx)(n.li,{children:"Many sites disable it entirely"}),` `]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Webmentions:"})}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"Simpler attack surface"}),` `,(0,e.jsx)(n.li,{children:"Easier to implement rate limiting"}),` `,(0,e.jsx)(n.li,{children:"Better security best practices"}),` `,(0,e.jsx)(n.li,{children:"Asynchronous processing reduces attack vectors"}),` `]}),` `,(0,e.jsxs)(n.h2,{id:"technical-comparison",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#technical-comparison",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Technical Comparison"]}),` `,(0,e.jsxs)(n.h3,{id:"pingback-request",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#pingback-request",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Pingback Request"]}),` `,(0,e.jsx)(n.p,{children:"A Pingback request looks like this:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-xml",children:` pingback.ping source_url target_url `})}),` `,(0,e.jsxs)(n.h3,{id:"webmention-request",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#webmention-request",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Webmention Request"]}),` `,(0,e.jsx)(n.p,{children:"A Webmention request is much simpler:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-http",children:`POST /webmention HTTP/1.1 Host: example.com Content-Type: application/x-www-form-urlencoded source=https://source.example.com/post&target=https://example.com/article `})}),` `,(0,e.jsxs)(n.h2,{id:"feature-comparison",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#feature-comparison",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Feature Comparison"]}),` `,(0,e.jsxs)(n.table,{children:[(0,e.jsx)(n.thead,{children:(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.th,{children:"Feature"}),(0,e.jsx)(n.th,{children:"Pingback"}),(0,e.jsx)(n.th,{children:"Webmention"})]})}),(0,e.jsxs)(n.tbody,{children:[(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.td,{children:"Protocol"}),(0,e.jsx)(n.td,{children:"XML-RPC"}),(0,e.jsx)(n.td,{children:"HTTP POST"})]}),(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.td,{children:"Data Format"}),(0,e.jsx)(n.td,{children:"XML"}),(0,e.jsx)(n.td,{children:"Form-encoded"})]}),(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.td,{children:"Metadata"}),(0,e.jsx)(n.td,{children:"None"}),(0,e.jsx)(n.td,{children:"Microformats"})]}),(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.td,{children:"Interaction Types"}),(0,e.jsx)(n.td,{children:"Link only"}),(0,e.jsx)(n.td,{children:"Replies, likes, reposts, etc."})]}),(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.td,{children:"Verification"}),(0,e.jsx)(n.td,{children:"Basic"}),(0,e.jsx)(n.td,{children:"Rich"})]}),(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.td,{children:"Security"}),(0,e.jsx)(n.td,{children:"Vulnerable"}),(0,e.jsx)(n.td,{children:"More secure"})]}),(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.td,{children:"Spam Prevention"}),(0,e.jsx)(n.td,{children:"Limited"}),(0,e.jsx)(n.td,{children:"Flexible"})]}),(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.td,{children:"Debugging"}),(0,e.jsx)(n.td,{children:"Difficult"}),(0,e.jsx)(n.td,{children:"Easy"})]}),(0,e.jsxs)(n.tr,{children:[(0,e.jsx)(n.td,{children:"Modern Support"}),(0,e.jsx)(n.td,{children:"Declining"}),(0,e.jsx)(n.td,{children:"Growing"})]})]})]}),` `,(0,e.jsxs)(n.h2,{id:"why-webmentions-won",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#why-webmentions-won",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Why Webmentions Won"]}),` `,(0,e.jsx)(n.p,{children:"The web community has largely moved toward Webmentions because:"}),` `,(0,e.jsxs)(n.ol,{children:[` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"Simpler to implement"}),": No XML-RPC required"]}),` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"More secure"}),": Fewer attack vectors"]}),` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"Richer data"}),": Microformats support"]}),` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"Better ecosystem"}),": Active development and community"]}),` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"W3C standard"}),": Official recommendation since 2017"]}),` `]}),` `,(0,e.jsxs)(n.h2,{id:"migration-path",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#migration-path",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Migration Path"]}),` `,(0,e.jsx)(n.p,{children:"If you're currently using Pingbacks, migrating is straightforward:"}),` `,(0,e.jsxs)(n.h3,{id:"1-keep-pingbacks-running-optional",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#1-keep-pingbacks-running-optional",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"1. Keep Pingbacks Running (Optional)"]}),` `,(0,e.jsx)(n.p,{children:"You can support both during transition:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-html",children:` `})}),` `,(0,e.jsxs)(n.h3,{id:"2-convert-pingback-data",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#2-convert-pingback-data",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"2. Convert Pingback Data"]}),` `,(0,e.jsx)(n.p,{children:"Existing Pingbacks can be converted to Webmentions:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-javascript",children:`// Pseudocode for migration const webmentions = pingbacks.map(pingback => ({ source: pingback.source_url, target: pingback.target_url, verified: true, type: 'mention', receivedAt: pingback.created_at })); `})}),` `,(0,e.jsxs)(n.h3,{id:"3-disable-pingbacks",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#3-disable-pingbacks",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"3. Disable Pingbacks"]}),` `,(0,e.jsx)(n.p,{children:"Once Webmentions are working, you can safely disable Pingbacks:"}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"WordPress:"})}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-php",children:`// In functions.php add_filter('xmlrpc_enabled', '__return_false'); add_filter('pings_open', '__return_false', 10, 2); `})}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Nginx:"})}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-nginx",children:`location = /xmlrpc.php { deny all; } `})}),` `,(0,e.jsxs)(n.h2,{id:"real-world-example",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#real-world-example",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Real-World Example"]}),` `,(0,e.jsxs)(n.h3,{id:"pingback-flow",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#pingback-flow",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Pingback Flow"]}),` `,(0,e.jsxs)(n.ol,{children:[` `,(0,e.jsx)(n.li,{children:"Alice writes a post linking to Bob's article"}),` `,(0,e.jsx)(n.li,{children:"Alice's system sends XML-RPC request to Bob"}),` `,(0,e.jsx)(n.li,{children:"Bob's system parses XML, verifies link exists"}),` `,(0,e.jsx)(n.li,{children:'Bob shows "Alice linked to this" (no context)'}),` `]}),` `,(0,e.jsxs)(n.h3,{id:"webmention-flow",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#webmention-flow",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Webmention Flow"]}),` `,(0,e.jsxs)(n.ol,{children:[` `,(0,e.jsx)(n.li,{children:"Alice writes a post linking to Bob's article"}),` `,(0,e.jsx)(n.li,{children:"Alice's system sends HTTP POST to Bob's endpoint"}),` `,(0,e.jsx)(n.li,{children:"Bob's system fetches Alice's page"}),` `,(0,e.jsx)(n.li,{children:"Bob parses microformats to get Alice's name, photo, and quote"}),` `,(0,e.jsx)(n.li,{children:'Bob shows "Alice replied: [preview of her thoughts]" with her photo'}),` `]}),` `,(0,e.jsxs)(n.h2,{id:"community-adoption",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#community-adoption",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Community Adoption"]}),` `,(0,e.jsx)(n.p,{children:"Major platforms supporting Webmentions:"}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"WordPress"}),": Via plugins (Webmention, Semantic Linkbacks)"]}),` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"Ghost"}),": Third-party integrations"]}),` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"Jekyll/Hugo/Eleventy"}),": Static site plugins"]}),` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"Micro.blog"}),": Native support"]}),` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.strong,{children:"Known"}),": Built-in support"]}),` `]}),` `,(0,e.jsx)(n.p,{children:"Most modern platforms have deprecated or removed Pingback support."}),` `,(0,e.jsxs)(n.h2,{id:"should-you-support-both",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#should-you-support-both",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Should You Support Both?"]}),` `,(0,e.jsxs)(n.p,{children:[(0,e.jsx)(n.strong,{children:"Short answer"}),": No, focus on Webmentions."]}),` `,(0,e.jsxs)(n.p,{children:[(0,e.jsx)(n.strong,{children:"Exceptions"}),":"]}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"You have many legacy Pingback connections"}),` `,(0,e.jsx)(n.li,{children:"You're transitioning and need overlap"}),` `,(0,e.jsx)(n.li,{children:"Your CMS supports both with zero effort"}),` `]}),` `,(0,e.jsx)(n.p,{children:"Otherwise, Webmentions provide everything Pingbacks did and much more, with better security and developer experience."}),` `,(0,e.jsxs)(n.h2,{id:"learn-more",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#learn-more",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Learn More"]}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:(0,e.jsx)(n.a,{href:"https://www.w3.org/TR/webmention/",children:"Webmention spec"})}),` `,(0,e.jsxs)(n.li,{children:[(0,e.jsx)(n.a,{href:"http://www.hixie.ch/specs/pingback/pingback",children:"Pingback spec"})," (deprecated)"]}),` `,(0,e.jsx)(n.li,{children:(0,e.jsx)(n.a,{href:"https://indieweb.org/pingback#How_to_instead",children:"IndieWeb comparison"})}),` `]})]})}function h(i={}){let{wrapper:n}=i.components||{};return n?(0,e.jsx)(n,{...i,children:(0,e.jsx)(s,{...i})}):s(i)}return x(P);})(); ;return Component;

Basics

How do Webmentions differ from Pingbacks?

Why should I use Webmentions on my site?