Kod QR vCard: format, pola, wersje i działający przykład
Co naprawdę zawiera kod QR vCard: format tekstowy linijka po linijce, pola, które rozumieją telefony, vCard 3.0, 4.0 czy MECARD i dlaczego długi kontakt daje kod trudny do zeskanowania.
W tym poradniku pokazujemy format linijka po linijce, podpowiadamy, której wersji użyć i ile danych się zmieści, a także wyjaśniamy, kiedy lepiej, by generator kodów QR vCard zapisał w kodzie krótki link zamiast surowego kontaktu.
Jak wygląda format vCard w kodzie QR
Oto kompletny, poprawny kontakt. Każda linia to jedna właściwość: nazwa pola, dwukropek i wartość.
BEGIN:VCARD
VERSION:3.0
N:Rivera;Alex;;;
FN:Alex Rivera
ORG:Example Studio
TITLE:Account Manager
TEL;TYPE=CELL:+12025550123
EMAIL:[email protected]
URL:https://example.com
ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA
END:VCARDCały format opiera się na trzech zasadach:
- Wizytówka zaczyna się od BEGIN:VCARD i kończy na END:VCARD, a linia VERSION następuje zaraz po pierwszej z nich.
- Każda właściwość zajmuje osobną linię. Średniki rozdzielają części wartości złożonej, np. elementy imienia i nazwiska albo adresu.
- Przecinek, średnik lub ukośnik wsteczny, który jest częścią samego tekstu, poprzedza się ukośnikiem wstecznym, więc „Smith, Jones and Co” zapisuje się jako „Smith\, Jones and Co”.
Pola vCard, które rozumieją telefony
Kontakt może zawierać dziesiątki właściwości, ale to te są konsekwentnie odczytywane przez aplikacje kontaktów w telefonach:
| Pole | Co zawiera | Przykład |
|---|---|---|
| FN | Pełne imię i nazwisko w takiej postaci, w jakiej ma się wyświetlać. Wymagane. | FN:Alex Rivera |
| N | Imię i nazwisko w częściach: nazwisko, imię, drugie imiona, przedrostek, przyrostek. Wymagane w wersji 3.0. | N:Rivera;Alex;;; |
| ORG | Firma lub organizacja | ORG:Example Studio |
| TITLE | Stanowisko | TITLE:Account Manager |
| TEL | Numer telefonu. TYPE oznacza go jako CELL (komórkowy), WORK (służbowy) lub HOME (domowy). | TEL;TYPE=CELL:+12025550123 |
| Adres e-mail | EMAIL:[email protected] | |
| URL | Strona internetowa | URL:https://example.com |
| ADR | Adres pocztowy w siedmiu częściach: skrytka pocztowa, numer lokalu, ulica, miejscowość, stan lub region, kod pocztowy, kraj. | ADR;TYPE=WORK:;;100 Main Street;Springfield;IL;62701;USA |
| NOTE | Dowolna notatka | NOTE:Spotkanie na targach |
Numery telefonów zapisuj w formacie międzynarodowym z numerem kierunkowym kraju, np. +48 dla Polski, aby zapisany kontakt dało się wybrać z dowolnego miejsca.
Format ma też pole PHOTO, ale zdjęcie w kodzie QR to niepraktyczny pomysł. Osadzony obraz zajmuje dziesiątki tysięcy znaków, a kod QR mieści najwyżej 2953 bajty danych. W kodzie statycznym pomiń zdjęcie albo użyj hostowanej wizytówki kontaktowej, która pokazuje je na stronie.
vCard 2.1, 3.0 czy 4.0: której wersji użyć
W obiegu są trzy wersje formatu:
- vCard 2.1 (1996) to najstarsza wersja. Większość telefonów nadal ją odczytuje, ale znaki z akcentami i znaki spoza alfabetu łacińskiego wymagają w niej dodatkowych oznaczeń.
- vCard 3.0 (1998) to wersja, którą zapisuje większość generatorów kodów QR, i najbezpieczniejszy wybór do kodu QR. Aparaty w telefonach iPhone i Android odczytują ją niezawodnie.
- vCard 4.0 (2011) to aktualny standard, zdefiniowany w RFC 6350. Zawsze używa UTF-8 i ma czytelniejszą składnię, ale aplikacje aparatu obsługują go mniej konsekwentnie, a według zgłoszeń niektóre telefony gubią pola lub źle wyświetlają znaki specjalne.
Używaj wersji 3.0, chyba że masz konkretny powód, by tego nie robić, i zapisuj tekst w UTF-8, aby imiona i nazwiska ze znakami diakrytycznymi, np. polskimi, lub zapisane w innych alfabetach przetrwały skanowanie bez zmian.
MECARD: zwięzła alternatywa
MECARD to krótszy format kontaktu, który NTT DOCOMO stworzyło na potrzeby kodów QR w japońskich telefonach. Cały kontakt mieści się w nim w jednej linii:
MECARD:N:Rivera,Alex;TEL:+12025550123;EMAIL:[email protected];;Ponieważ zajmuje mniej znaków, kod QR jest mniej gęsty i łatwiej go zeskanować w małym rozmiarze. Ceną jest mniejsza liczba pól: MECARD nie ma miejsca na nazwę firmy ani stanowisko, a jego obsługa różni się między aplikacjami do skanowania bardziej niż w przypadku vCard. Wybierz go tylko wtedy, gdy kod musi być bardzo mały, a imię i nazwisko, numer telefonu i e-mail wystarczą.
Ile danych kontaktowych się zmieści i dlaczego mniej znaczy lepiej
Kod QR może pomieścić do 2953 bajtów, ale to górna granica dla największej i najgęstszej wersji, a nie cel do osiągnięcia. Każdy dodany znak powiększa wzór: przybywa modułów, a przy tym samym rozmiarze wydruku każdy z nich jest mniejszy.
Przykładowy kontakt powyżej ma 247 znaków. Przy średnim poziomie korekcji błędów potrzebuje wzoru o szerokości 61 modułów, więc na wizytówce, wydrukowany w szerokości 2,5 cm, ma moduły o boku około 0,4 mm. Krótki link z 22 znakami potrzebuje tylko 25 modułów, co przy tym samym rozmiarze daje moduł o boku 1 mm. To właśnie większe moduły pozwalają szybko zeskanować kod przy słabym świetle, na papierze z fakturą albo starszym telefonem.
Aby statyczny kod vCard pozostał czytelny:
- Umieść w nim tylko to, czego ktoś potrzebuje, żeby się z Tobą skontaktować: imię i nazwisko, jeden numer telefonu, jeden e-mail i stronę internetową.
- Pomiń zdjęcie, długie notatki i pełny adres pocztowy, chyba że są naprawdę ważne.
- Drukuj go w większym rozmiarze niż kod do linku. Minimalne rozmiary znajdziesz w przewodniku po rozmiarach kodów QR do druku.
Statyczny kod vCard a dynamiczna wizytówka kontaktowa
Kontakt można umieścić w kodzie QR na dwa sposoby.
Statyczny kod vCard zapisuje tekst vCard bezpośrednio we wzorze. Działa bez internetu i bez żadnej usługi w tle, a do tego nigdy nie wygasa. Nie da się go jednak zmienić: nowy numer telefonu oznacza nowy kod i ponowny druk.
Dynamiczny kod vCard przechowuje krótki link. Skanowanie otwiera stronę z wizytówką kontaktową i przyciskiem Zapisz kontakt, który pobiera plik .vcf. Dane są przechowywane na serwerze, więc możesz je edytować po wydrukowaniu, wzór pozostaje mały, a strona może pokazać zdjęcie i dodatkowe linki.
| Pytanie | Statyczny kod vCard | Dynamiczny kod vCard |
|---|---|---|
| Co zapisuje wzór | Pełny tekst vCard | Krótki link |
| Działa offline | Tak | Nie, skanowanie wymaga połączenia |
| Można edytować po wydrukowaniu | Nie | Tak |
| Gęstość wzoru | Rośnie z każdym polem | Pozostaje taka sama |
| Zdjęcie | Niepraktyczne | Widoczne na wizytówce kontaktowej |
| Zależy od dostawcy | Nie | Tak |
Przy wizytówce, którą będziesz rozdawać latami, albo przy dużych nakładach bezpieczniejszy jest kod dynamiczny. Szerzej o tym wyborze piszemy w artykule Kody QR dynamiczne kontra statyczne, a o rozmiarze i umiejscowieniu kodu na samej wizytówce w przewodniku po kodach QR na wizytówkach.
Jak zrobić kod QR vCard
Nie musisz wpisywać formatu ręcznie. Kreator kodów QR vCard zbuduje go na podstawie formularza:
- Otwórz generator kodów QR vCard w QR Cake.
- Wpisz imię i nazwisko, firmę, stanowisko, numer telefonu, e-mail i stronę internetową. Jeśli chcesz, dodaj zdjęcie i profile społecznościowe, które mają się pojawić na wizytówce.
- Dopasuj wygląd kodu: kolory, logo lub ramkę z napisem, np. „Zeskanuj, aby zapisać mój kontakt”.
- Zaloguj się na darmowe konto i zapisz kod, a potem pobierz go jako PNG lub SVG.
- Zeskanuj go iPhone'em i telefonem z Androidem, na każdym dotknij Zapisz kontakt i przed drukiem sprawdź zapisany wpis.
Kod vCard zapisany w QR Cake jest dynamiczny. Wzór zawiera krótki link, skanowanie otwiera Twoją hostowaną wizytówkę kontaktową, a przycisk Zapisz kontakt pobiera standardowy plik vCard 3.0. Plan darmowy obejmuje do 5 dynamicznych kodów z nielimitowanymi skanowaniami, a zapisane kody nie wygasają. W planie darmowym przed otwarciem wizytówki na chwilę pojawia się strona z reklamą, a płatne plany ją usuwają.
Jak sprawdzić, co zawiera kod QR vCard
Aby zobaczyć, co przechowuje istniejący kod, zeskanuj go i sprawdź, co proponuje telefon. Podgląd kontaktu z opcją dodania go do kontaktów oznacza, że tekst vCard jest zapisany we wzorze, czyli kod jest statyczny. Adres internetowy oznacza, że kod jest dynamiczny. Możesz też wgrać zdjęcie lub zrzut ekranu kodu do czytnika kodów QR, który pokaże odczytaną zawartość.
Częste błędy w kodach QR vCard
- Brak linii VERSION lub END:VCARD. Telefon może wtedy pokazać kod jako zwykły tekst, a nie kontakt.
- Przecinki i średniki bez ukośnika. Nazwa firmy taka jak „Smith, Jones” rozpadnie się na dwie wartości, jeśli przecinka nie poprzedza ukośnik wsteczny.
- Za dużo danych. Kilka numerów telefonu, długa notatka i pełny adres zamieniają kod na wizytówce w gęsty kwadrat, którego starsze aparaty nie są w stanie odczytać.
- Osadzone zdjęcie. Nie zmieści się. Jeśli zdjęcie jest ważne, użyj hostowanej wizytówki kontaktowej.
- Numery w formacie krajowym. Numer bez numeru kierunkowego kraju nie zadziała u nikogo, kto dzwoni z zagranicy.
- Brak testu na obu platformach. Aplikacje kontaktów na iPhonie i Androidzie układają te same pola inaczej, więc sprawdź zapisany wpis na każdej z nich.
W skrócie
Kod QR vCard to kontakt w formacie zwykłego tekstu: BEGIN:VCARD, linia VERSION, po jednym polu w linii, END:VCARD. Używaj wersji 3.0, ogranicz pola do niezbędnego minimum i zapisuj tekst w UTF-8. Jeśli dane mogą się zmienić albo kod ma być mały, użyj dynamicznego kodu vCard, który przechowuje krótki link i pokazuje kontakt na stronie, którą możesz edytować.
Generator kodów QR vCard
Stwórz kod QR vCard, zwany też kodem QR wizytówki. Jedno skanowanie pokazuje Twoje zdjęcie, telefon, e-mail i adres z przyciskiem „Zapisz kontakt”. Darmowy i dynamiczny.
O zespole QR Cake
Tekst przygotowany przez zespół QR Cake, ludzi, którzy tworzą QR Cake, platformę dynamicznych kodów QR wykorzystywaną do edytowalnych kampanii drukowanych, kodów QR w Canvie, analityki skanów i długowiecznych przekierowań QR, które działają dalej nawet po zakończeniu subskrypcji.
Dowiedz się więcej o QR CakeCzęsto zadawane pytania
- Jakiego formatu używa kod QR vCard?
- Używa formatu vCard, czyli tego samego zwykłego tekstu, który znajduje się w pliku .vcf. Dane zaczynają się od BEGIN:VCARD, potem następuje linia VERSION i po jednej właściwości w każdej linii, np. FN dla imienia i nazwiska, TEL dla numeru telefonu i EMAIL dla adresu e-mail, a na końcu END:VCARD.
- Której wersji vCard użyć w kodzie QR?
- Użyj vCard 3.0. Tę wersję zapisuje większość generatorów kodów QR i to ją aparaty w telefonach iPhone i Android odczytują najbardziej konsekwentnie. vCard 4.0 to nowszy standard, ale aplikacje aparatu obsługują go mniej równo.
- Czym różni się vCard od MECARD?
- MECARD to zwięzły format kontaktu stworzony przez NTT DOCOMO, który mieści cały kontakt w jednej linii. Zajmuje mniej znaków, więc kod QR jest mniej gęsty, ale ma mniej pól: nie ma w nim miejsca na nazwę firmy ani stanowisko, a jego obsługa w aplikacjach do skanowania bywa bardziej zróżnicowana.
- Ile informacji zmieści kod QR vCard?
- Kod QR mieści do 2953 bajtów, ale tak pełny kod jest zbyt gęsty, by w rozmiarze wizytówki niezawodnie się skanował. Ogranicz statyczny kod vCard do kilkuset znaków: imię i nazwisko, jeden numer telefonu, jeden e-mail i strona internetowa.
- Czy kod QR vCard może zawierać zdjęcie?
- W kodzie statycznym nie. Osadzone zdjęcie jest znacznie większe, niż kod QR jest w stanie pomieścić. Dynamiczny kod vCard może pokazać zdjęcie, bo skanowanie otwiera hostowaną stronę z wizytówką kontaktową, zamiast odczytywać kontakt ze wzoru.
- Czy mogę edytować kod QR vCard po wydrukowaniu?
- Tylko jeśli jest dynamiczny. Statyczny kod vCard ma dane kontaktowe zapisane we wzorze, więc każda zmiana wymaga nowego kodu. Dynamiczny kod vCard przechowuje krótki link, a dane, do których prowadzi, możesz edytować w dowolnej chwili.
- Czy kod QR vCard działa bez internetu?
- Statyczny kod vCard tak, bo telefon odczytuje kontakt bezpośrednio ze wzoru. Dynamiczny kod vCard wymaga połączenia, bo skanowanie otwiera stronę internetową, na której zapisany jest kontakt.
Powiązane artykuły
Czytaj dalej praktyczne poradniki, przykłady i wskazówki optymalizacyjne dotyczące kodów QR.
Przewodnik po kodach QR na wizytówkach: rozmiar, umiejscowienie i co linkować (2026)
Kod QR na wizytówce to najbardziej opłacalne zastosowanie kodów QR w druku. Wizytówka żyje tak długo, jak jej projekt, a miejsce docelowe aktualizuje się razem z Twoją karierą.
Kody QR dynamiczne kontra statyczne: których naprawdę powinieneś używać? (przewodnik 2026)
Kody statyczne sprawdzają się w mniej więcej trzech konkretnych sytuacjach. We wszystkich pozostałych przypadkach dynamiczne pozwalają zaoszczędzić pieniądze i czas oraz uniknąć wstydu związanego z dodrukowaniem ulotek tylko dlatego, że ktoś zmienił adres strony docelowej.
Przewodnik po rozmiarach kodów QR do druku: kompendium na 2026 rok
Kody QR najczęściej zawodzą przy małych rozmiarach. Rozwiązanie jest proste: wydrukuj je wystarczająco duże. Ten przewodnik podaje zasady, liczby oraz minimalne rozmiary w zależności od zastosowania.