Skip to main content
The remaining built-in data types cover three everyday use cases that don’t fit neatly into contact or communication categories: connecting a device to a wireless network, dropping a pin on a map, and adding a calendar event — all with a single scan.

​
WiFi

QrCode::WiFi() produces a WIFI: scheme payload that iOS and Android camera apps parse natively. Scanning the code connects the device to the network without the user having to type the password.

​
Signature

QrCode::WiFi(array $credentials)
​
ssid
string
required
The network SSID. Must not be empty.
​
encryption
string
The security protocol: WEP, WPA, WPA2, WPA3, or NOPASS. WPA2 and WPA3 are both normalised to WPA in the payload (as per the spec). Omit this key to let the package infer WPA when a password is provided, or NOPASS for open networks.
​
password
string
The network password. Omit for open (NOPASS) networks. Passing a password alongside NOPASS throws an InvalidWiFiArgumentException.
​
hidden
boolean
Set to true if the network SSID is hidden. Defaults to false.
WEP is deprecated and insecure. It is supported only for compatibility with legacy hardware. Use WPA or WPA2 for all new deployments.

​
Examples

use Linkxtr\QrCode\Facades\QrCode;

// WPA2 network (most common)
$qr = QrCode::WiFi([
    'ssid'       => 'OfficeNetwork',
    'encryption' => 'WPA2',
    'password'   => 's3cur3P@ssw0rd',
]);

// Open network — no password
$qr = QrCode::WiFi([
    'ssid'       => 'GuestWifi',
    'encryption' => 'NOPASS',
]);

// Hidden SSID
$qr = QrCode::WiFi([
    'ssid'       => 'HiddenNetwork',
    'encryption' => 'WPA',
    'password'   => 'mypassword',
    'hidden'     => true,
]);

// Render as a 400 px PNG for printing on a sign
echo QrCode::WiFi([
    'ssid'       => 'CafeWifi',
    'encryption' => 'WPA',
    'password'   => 'welcome2025',
])->format('png')->size(400)->generate();

​
Geo

QrCode::Geo() produces a geo: URI (RFC 5870). Scanning it opens the device’s default maps application with a pin at the specified coordinates and an optional location name.

​
Signature

QrCode::Geo(
    float   $latitude,
    float   $longitude,
    ?string $name = null,
)
​
latitude
float
required
Decimal latitude between -90 and 90. Values outside this range throw an InvalidGeoArgumentException.
​
longitude
float
required
Decimal longitude between -180 and 180. Values outside this range throw an InvalidGeoArgumentException.
​
name
string
An optional human-readable place name appended as a name query parameter.

​
Examples

use Linkxtr\QrCode\Facades\QrCode;

// Coordinates only
$qr = QrCode::Geo(37.7749, -122.4194);

// With a place name
$qr = QrCode::Geo(37.7749, -122.4194, 'San Francisco City Hall');

// Eiffel Tower
$qr = QrCode::Geo(48.858370, 2.294481, 'Eiffel Tower');

// Render inline
echo QrCode::Geo(51.5074, -0.1278, 'London')->size(300)->generate();

// Save as PNG
QrCode::Geo(40.7128, -74.0060, 'New York City')
    ->format('png')
    ->size(400)
    ->generate(storage_path('app/qrcodes/nyc.png'));

​
CalendarEvent

QrCode::CalendarEvent() produces an iCalendar (RFC 5545) VCALENDAR payload. Scanning it prompts the device to add the event to the user’s calendar with all details pre-filled.

​
Signature

QrCode::CalendarEvent(array $attributes)
​
summary
string
required
The event title. Must not be empty.
​
start
Carbon|DateTimeInterface|string|int
required
The event start date and time. Accepts a Carbon instance, any DateTimeInterface, a parseable date string, or a Unix timestamp integer.
​
end
Carbon|DateTimeInterface|string|int
required
The event end date and time. Must be strictly after start; otherwise an InvalidCalendarEventArgumentException is thrown.
​
description
string
An optional longer description of the event.
​
location
string
An optional event location string.
Per RFC 5545, the DTSTAMP field is set to the current UTC timestamp every time the payload is serialised. This means generating a QR code for the same event twice will produce different binary outputs and the result cannot be strictly cached by content hash. If you need a stable, reproducible QR code, generate it once, save the result to disk, and serve the saved file.

​
Examples

use Carbon\Carbon;
use Linkxtr\QrCode\Facades\QrCode;

// Basic event
$qr = QrCode::CalendarEvent([
    'summary' => 'Team Stand-up',
    'start'   => Carbon::create(2025, 9, 1, 9, 0, 0, 'America/New_York'),
    'end'     => Carbon::create(2025, 9, 1, 9, 30, 0, 'America/New_York'),
]);

// Full event with description and location
$qr = QrCode::CalendarEvent([
    'summary'     => 'Laracon US 2025',
    'description' => 'The official Laravel conference. Join us for talks, workshops, and networking.',
    'location'    => 'Nashville, TN, USA',
    'start'       => Carbon::create(2025, 8, 27, 9, 0, 0, 'America/Chicago'),
    'end'         => Carbon::create(2025, 8, 28, 17, 0, 0, 'America/Chicago'),
]);

// Using a date string instead of Carbon
$qr = QrCode::CalendarEvent([
    'summary' => 'Project Deadline',
    'start'   => '2025-10-31 08:00:00',
    'end'     => '2025-10-31 09:00:00',
]);

// Render inline
echo QrCode::CalendarEvent([
    'summary' => 'Coffee Chat',
    'start'   => Carbon::now()->addDay()->setTime(10, 0),
    'end'     => Carbon::now()->addDay()->setTime(10, 30),
])->size(400)->generate();

// Save to disk — do this once and cache the file path, not the QR payload
QrCode::CalendarEvent([
    'summary'  => 'Laracon US 2025',
    'location' => 'Nashville, TN',
    'start'    => Carbon::create(2025, 8, 27, 9, 0, 0, 'America/Chicago'),
    'end'      => Carbon::create(2025, 8, 28, 17, 0, 0, 'America/Chicago'),
])->format('png')
  ->size(500)
  ->generate(storage_path('app/qrcodes/laracon-2025.png'));
All timestamps are converted to UTC before being written into the payload, regardless of the timezone on the Carbon instance you pass in. Pass timezone-aware Carbon objects (e.g. Carbon::create(..., 'America/Chicago')) to ensure the event appears at the correct local time on the recipient’s device.