var Component=(()=>{var p=Object.create;var o=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var g=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var f=(i,n)=>()=>(n||i((n={exports:{}}).exports,n),n.exports),k=(i,n)=>{for(var r in n)o(i,r,{get:n[r],enumerable:!0})},a=(i,n,r,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let t of m(n))!b.call(i,t)&&t!==r&&o(i,t,{get:()=>n[t],enumerable:!(s=u(n,t))||s.enumerable});return i};var w=(i,n,r)=>(r=i!=null?p(g(i)):{},a(n||!i||!i.__esModule?o(r,"default",{value:i,enumerable:!0}):r,i)),y=i=>a(o({},"__esModule",{value:!0}),i);var l=f((I,c)=>{c.exports=_jsx_runtime});var N={};k(N,{default:()=>h,frontmatter:()=>v});var e=w(l()),v={title:"Why aren't my Webmentions showing up?",description:"Common issues preventing Webmentions from working and how to debug and fix them.",category:"troubleshooting",order:1,published:!0};function d(i){let n={a:"a",code:"code",h2:"h2",h3:"h3",input:"input",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:"Webmentions not appearing can be frustrating, but the issue usually falls into one of a few common categories. This guide will help you debug and fix the problem."}),` `,(0,e.jsxs)(n.h2,{id:"quick-diagnostic-checklist",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#quick-diagnostic-checklist",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Quick Diagnostic Checklist"]}),` `,(0,e.jsx)(n.p,{children:"Before diving deep, check these basics:"}),` `,(0,e.jsxs)(n.ul,{className:"contains-task-list",children:[` `,(0,e.jsxs)(n.li,{className:"task-list-item",children:[(0,e.jsx)(n.input,{type:"checkbox",disabled:!0})," ","Is your Webmention endpoint discoverable?"]}),` `,(0,e.jsxs)(n.li,{className:"task-list-item",children:[(0,e.jsx)(n.input,{type:"checkbox",disabled:!0})," ","Is the endpoint URL returning 200/202 responses?"]}),` `,(0,e.jsxs)(n.li,{className:"task-list-item",children:[(0,e.jsx)(n.input,{type:"checkbox",disabled:!0})," ","Does the source page actually link to the target?"]}),` `,(0,e.jsxs)(n.li,{className:"task-list-item",children:[(0,e.jsx)(n.input,{type:"checkbox",disabled:!0})," ","Are you checking the right target URL (http vs https, trailing slash)?"]}),` `,(0,e.jsxs)(n.li,{className:"task-list-item",children:[(0,e.jsx)(n.input,{type:"checkbox",disabled:!0})," ","Have you waited long enough for async processing?"]}),` `]}),` `,(0,e.jsxs)(n.h2,{id:"1-endpoint-discovery-issues",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#1-endpoint-discovery-issues",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"1. Endpoint Discovery Issues"]}),` `,(0,e.jsxs)(n.h3,{id:"problem-senders-cant-find-your-endpoint",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#problem-senders-cant-find-your-endpoint",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Problem: Senders Can't Find Your Endpoint"]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Symptoms:"})}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"No Webmentions received at all"}),` `,(0,e.jsx)(n.li,{children:"Works with Telegraph but not automatically"}),` `,(0,e.jsx)(n.li,{children:"Endpoint logs show no incoming requests"}),` `]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Check:"})}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-html",children:` `})}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Test endpoint discovery:"})}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-bash",children:`# Check HTML curl -s https://yourdomain.com/your-post | grep webmention # Check HTTP headers curl -I https://yourdomain.com/your-post | grep -i link `})}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Common Mistakes:"})}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-html",children:` `})}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Solution:"})}),` `,(0,e.jsxs)(n.p,{children:["Ensure the link tag is in the ",(0,e.jsx)(n.code,{children:""})," of every page:"]}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-html",children:` `})}),` `,(0,e.jsxs)(n.h2,{id:"2-endpoint-not-responding",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#2-endpoint-not-responding",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"2. Endpoint Not Responding"]}),` `,(0,e.jsxs)(n.h3,{id:"problem-endpoint-returns-errors",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#problem-endpoint-returns-errors",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Problem: Endpoint Returns Errors"]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Symptoms:"})}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"Senders receive 404, 500, or timeout errors"}),` `,(0,e.jsx)(n.li,{children:"Webmentions work sporadically"}),` `,(0,e.jsx)(n.li,{children:"Endpoint logs show errors"}),` `]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Test your endpoint:"})}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-bash",children:`curl -X POST https://yourdomain.com/webmention \\ -d "source=https://test.example.com" \\ -d "target=https://yourdomain.com/post" `})}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Expected response:"})}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-http",children:`HTTP/1.1 202 Accepted `})}),` `,(0,e.jsx)(n.p,{children:"or"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-http",children:`HTTP/1.1 200 OK `})}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Common Issues:"})}),` `,(0,e.jsxs)(n.h3,{id:"404-not-found",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#404-not-found",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"404 Not Found"]}),` `,(0,e.jsx)(n.p,{children:"Your endpoint route isn't registered:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-javascript",children:`// \u274C Wrong: No route handler app.listen(3000); // \u2705 Correct: Route registered app.post('/webmention', handler); app.listen(3000); `})}),` `,(0,e.jsxs)(n.h3,{id:"405-method-not-allowed",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#405-method-not-allowed",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"405 Method Not Allowed"]}),` `,(0,e.jsx)(n.p,{children:"Endpoint doesn't accept POST:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-javascript",children:`// \u274C Wrong: Using GET app.get('/webmention', handler); // \u2705 Correct: Using POST app.post('/webmention', handler); `})}),` `,(0,e.jsxs)(n.h3,{id:"500-internal-server-error",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#500-internal-server-error",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"500 Internal Server Error"]}),` `,(0,e.jsx)(n.p,{children:"Check your error logs:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-javascript",children:`app.post('/webmention', async (req, res) => { try { // Your code } catch (error) { console.error('Webmention error:', error); res.status(500).send('Error'); } }); `})}),` `,(0,e.jsxs)(n.h2,{id:"3-verification-failures",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#3-verification-failures",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"3. Verification Failures"]}),` `,(0,e.jsxs)(n.h3,{id:"problem-mentions-dont-pass-verification",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#problem-mentions-dont-pass-verification",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Problem: Mentions Don't Pass Verification"]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Symptoms:"})}),` `,(0,e.jsxs)(n.ul,{children:[` `,(0,e.jsx)(n.li,{children:"Endpoint receives mentions but doesn't save them"}),` `,(0,e.jsx)(n.li,{children:"Test mentions work but real ones don't"}),` `,(0,e.jsx)(n.li,{children:'Mentions marked as "unverified"'}),` `]}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Common Causes:"})}),` `,(0,e.jsxs)(n.h3,{id:"url-mismatch",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#url-mismatch",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"URL Mismatch"]}),` `,(0,e.jsx)(n.p,{children:"The target URL in the mention doesn't exactly match your page URL:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-javascript",children:`// Mention sent for: target: "https://yourdomain.com/post" // But your page URL is: actual: "https://yourdomain.com/post/" // Note trailing slash `})}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Solution:"})}),` `,(0,e.jsx)(n.p,{children:"Normalize URLs before comparison:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-javascript",children:`function normalizeUrl(url) { const parsed = new URL(url); // Remove trailing slash parsed.pathname = parsed.pathname.replace(/\\/$/, ''); // Always use https if available if (parsed.protocol === 'http:') { parsed.protocol = 'https:'; } return parsed.href; } // Then compare: if (normalizeUrl(target) === normalizeUrl(yourPageUrl)) { // Match! } `})}),` `,(0,e.jsxs)(n.h3,{id:"link-not-found-in-source",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#link-not-found-in-source",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"Link Not Found in Source"]}),` `,(0,e.jsx)(n.p,{children:"Your verification is too strict or the source page has issues:"}),` `,(0,e.jsx)(n.p,{children:(0,e.jsx)(n.strong,{children:"Debug it:"})}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-javascript",children:`async function debugVerification(source, target) { const response = await fetch(source); const html = await response.text(); console.log('Looking for:', target); console.log('Page contains:', html.includes(target)); // Try variants const variants = [ target, target.replace('https://', 'http://'), target + '/', target.replace(/\\/$/, '') ]; variants.forEach(variant => { if (html.includes(variant)) { console.log('Found variant:', variant); } }); } `})}),` `,(0,e.jsxs)(n.h3,{id:"javascript-rendered-links",children:[(0,e.jsx)(n.a,{"aria-hidden":"true",tabIndex:"-1",href:"#javascript-rendered-links",children:(0,e.jsx)(n.span,{className:"icon icon-link"})}),"JavaScript-Rendered Links"]}),` `,(0,e.jsx)(n.p,{children:"The source page renders links with JavaScript after page load:"}),` `,(0,e.jsx)(n.pre,{children:(0,e.jsx)(n.code,{className:"language-html",children:`

Troubleshooting

How do I handle spam Webmentions?