Guide desk · Fourteen practical routes
Start with the mailto problem in front of you.
Test a link, repair a dead click or wrong-app handoff, handle a missing email client, compare the options, or add a webmail picker to the links you already have.
Install smart-mailto01 / 14
Start here
Replace a mailto link with smart-mailto
Install the core package, initialize it once, and keep your existing mailto anchors. The guide also explains native-mail and copy-address fallbacks.
npm install @smart-mailto/core@0.3.0Installation stalled? Share your setup feedback in Discussion #40 with your framework, first unclear step, exact error, and final outcome.
Read the installation guideRead by problem
Thirteen more ways in
Each route stays focused on one decision, failure mode, or practical job.
Learn mailto link syntax
Copy valid HTML, add optional fields, encode values, and understand what the client handoff can do.
Mailto link not working
Separate broken link markup from browser and operating-system mail-handler problems.
Mailto opens the wrong email app
Reset the browser or system default first, then offer a picker when the site cannot control visitor setup.
Mailto without an email client
Give visitors a working path when their device has no configured desktop mail handler.
Mailto not working in Chrome
Work through Chrome protocol handlers, Gmail registration, extensions, and system defaults.
Test a mailto link
Run a known-good link and separate broken HTML from browser or default mail-app setup.
Build a mailto link
Generate a correctly encoded mailto URL with recipients, subject, body, cc, and bcc fields.
Add multiple mailto recipients
Use valid HTML for multiple To, CC, and BCC addresses, then test the client handoff.
Encode a mailto subject and body
Handle spaces, punctuation, ampersands, question marks, and multiline body copy correctly.
Put a mailto link on a button
Style an accessible anchor as a button and keep the encoded mailto destination visible in HTML.
Use a prefilled email template
Start support, sales, and feedback emails with short editable prompts and safe placeholders.
Compare four mailto alternatives
Compare plain mailto, contact forms, copy-address controls, and smart-mailto without forcing one winner.
smart-mailto vs. plain mailto
See when a normal mailto link is enough and when a provider picker earns the extra step.