When a contact QR scans as plain text instead of offering Add Contact, the data inside the QR is not valid vCard or MECARD. The phone only offers to save a contact when the format is correct. Jump to your situation below or work through the methods in order.
A phone camera offers to save a contact only when a QR code contains a properly formatted vCard or MECARD payload. When it scans as plain text instead, the data inside is not valid contact data: it might be missing the BEGIN:VCARD and END:VCARD wrapper, use the wrong line endings, have invalid field syntax, or simply be plain text that a generator encoded by mistake. A QR that is too dense, because too much data was crammed in, can also fail to scan cleanly. The fix is to generate the QR from a correct vCard or MECARD string, keep the payload short with just the essential fields, use proper line endings, and test the scan on both iOS and Android. MECARD is often recognised more reliably by phone cameras than full vCard.
A QR code is just a container for text. Phone cameras look at that text and, if it matches a known contact format, offer to add a contact. The two formats they recognise are vCard (the same BEGIN:VCARD structure as a .vcf file) and MECARD (a compact single-line contact string).
If the text is anything else, even contact details written as plain words, the camera just shows it as text with no Add Contact option. So the problem is almost always how the QR was generated: the wrong format, a broken vCard structure, or so much data that the code will not scan reliably.
“The camera is binary about this: give it a real vCard or MECARD and it offers Add Contact, give it anything else and it just shows text. The usual mistake is using a plain-text QR generator and typing the details in, which encodes words, not a contact. The second mistake is cramming a photo or a paragraph of notes in until the QR is so dense it will not scan. Keep it to a name, a phone and an email, use a proper contact-QR generator, and if vCard is being fussy, MECARD scans more reliably on most phones.”
BEGIN:VCARD VERSION:3.0 N:Singh;Neeraj;;; FN:Neeraj Singh TEL:+10000000000 EMAIL:name@example.com END:VCARD
MECARD:N:Singh,Neeraj;TEL:+10000000000;EMAIL:name@example.com;;
Phones only offer Add Contact for a real vCard or MECARD payload, so the fix is almost always to use a proper contact-QR generator rather than a plain-text one. Keep the data minimal, name, phone and email, so the code is not too dense to scan. If vCard will not behave, MECARD is recognised more reliably across phone cameras.
If a correctly generated vCard or MECARD QR still scans as text, the scanner app may be the limitation, so test with the built-in camera app rather than a third-party scanner. If you are printing the code, increase its size and error-correction level so it scans reliably. You can also submit your error to us for a tailored fix.
