Skip to main content
The config/qrcode.php file is the central place to define default values that apply across every QR code your application generates through the facade, Blade component, or service container. Publishing it is optional — the package ships with sensible defaults — but it gives you full control without touching a single line of generation code.

​
Publish the config file

Run the following Artisan command to copy the config file into your application’s config/ directory: 
php artisan vendor:publish --tag=qrcode-config
After publishing, open config/qrcode.php and adjust the values to match your needs. Every QR code generated via the QrCode facade, the <x-qr-code> Blade component, or type-hinted Generator instances will automatically pick up these defaults.

​
Full config file

config/qrcode.php
<?php

declare(strict_types=1);

return [

    /*
    |--------------------------------------------------------------------------
    | Default Format
    |--------------------------------------------------------------------------
    |
    | Supported: "png", "eps", "svg", "webp"
    | Note: As of v2.4.x, the default 'format' is now "svg" (previously "png").
    |
    */
    'format' => env('QR_CODE_FORMAT', 'svg'),

    /*
    |--------------------------------------------------------------------------
    | Default Size
    |--------------------------------------------------------------------------
    |
    | Controls the default size of the QR code in pixels.
    | Note: As of v2.4.x, the default 'size' is now 400 (previously 200).
    |
    */
    'size' => (int) (env('QR_CODE_SIZE') ?? 400),

    /*
    |--------------------------------------------------------------------------
    | Default Margin
    |--------------------------------------------------------------------------
    |
    | Controls the default quiet zone (margin) around the QR code.
    |
    */
    'margin' => (int) (env('QR_CODE_MARGIN') ?? 4),

    /*
    |--------------------------------------------------------------------------
    | Default Color
    |--------------------------------------------------------------------------
    |
    | Controls the default foreground color of the QR code.
    | RGB (csv string):  "R,G,B"       e.g. "0,0,0"
    | RGBA (csv string): "R,G,B,A"     e.g. "0,0,0,100"
    | RGB (array):       [R, G, B]     e.g. [0, 0, 0]
    | RGBA (array):      [R, G, B, A]  e.g. [0, 0, 0, 100]
    | Hex:               "#RRGGBB"     e.g. "#000000"
    |
    */
    'color' => env('QR_CODE_COLOR', '0,0,0'),

    /*
    |--------------------------------------------------------------------------
    | Default Background Color
    |--------------------------------------------------------------------------
    |
    | Controls the default background color of the QR code.
    | Accepts the same formats as 'color' above.
    |
    */
    'background_color' => env('QR_CODE_BACKGROUND_COLOR', '255,255,255'),

    /*
    |--------------------------------------------------------------------------
    | Error Correction Level
    |--------------------------------------------------------------------------
    |
    | Supported: 'L', 'M', 'Q', 'H'
    | Note: As of v2.4.x, the default 'error_correction' is now 'M' (previously 'H').
    |
    */
    'error_correction' => env('QR_CODE_ERROR_CORRECTION', 'M'),

    /*
    |--------------------------------------------------------------------------
    | Encoding
    |--------------------------------------------------------------------------
    |
    | Controls the character encoding of the QR code.
    |
    */
    'encoding' => env('QR_CODE_ENCODING', 'UTF-8'),

    /*
    |--------------------------------------------------------------------------
    | Force GD Backend
    |--------------------------------------------------------------------------
    |
    | Force the package to bypass Imagick and fall back to the GD extension
    | for rendering raster images (PNG/WebP).
    |
    */
    'force_gd' => env('QR_CODE_FORCE_GD', false),

];

​
Config options

​
format
string
default:"svg"
The image format used for every generated QR code.
ValueDescription
svgScalable vector graphic. No image extension required. Renders crisply at any size.
pngRaster PNG — requires GD or Imagick
webpModern raster format — requires GD or Imagick
epsEncapsulated PostScript vector format for print workflows
The default changed from png to svg in v2.4.x. If you’re upgrading and rely on PNG output, set 'format' => 'png' (or QR_CODE_FORMAT=png in your .env).
​
size
integer
default:"400"
The width and height of the generated QR code, in pixels. Applies to raster formats (png, webp). For svg and eps this sets the viewBox dimensions.
'size' => 300,
​
margin
integer
default:"4"
The quiet zone (blank border) around the QR code, measured in module units. QR code specifications require a minimum margin of 4 for reliable scanning. Reduce this only when embedding QR codes inside a pre-padded container.
'margin' => 2,
​
color
string | array
default:"[0, 0, 0]"
The foreground (module) color of the QR code. Accepts any of the following formats:
FormatExample
RGB CSV string"0,0,0"
RGBA CSV string (alpha 0–100)"0,0,0,100"
RGB array[0, 0, 0]
RGBA array (alpha 0–100)[0, 0, 0, 100]
Hex string"#000000"
// Deep blue foreground
'color' => [30, 64, 175],
The alpha channel uses a 0–100 scale (not the 0–127 scale used internally by PHP GD). The package scales the value automatically.
​
background_color
string | array
default:"[255, 255, 255]"
The background color of the QR code. Accepts the same formats as color.
// Transparent background (PNG/WebP only)
'background_color' => [255, 255, 255, 0],
​
error_correction
string
default:"M"
The Reed-Solomon error correction level. Higher levels let scanners recover data from damaged or partially obscured codes, but increase the QR code’s visual density.
LevelData recoveryRecommended use
L~7 %Clean digital displays
M~15 %General purpose (default)
Q~25 %Printed materials
H~30 %Codes with an embedded logo
// Use H when merging a logo into the center of the QR code
'error_correction' => 'H',
​
encoding
string
default:"UTF-8"
The character encoding applied to the data payload before it is encoded into the QR code. Change this only if you need to encode content in a non-Unicode encoding supported by the underlying bacon/bacon-qr-code library.
'encoding' => 'UTF-8',
​
force_gd
boolean
default:"false"
When true, the package skips Imagick entirely and uses PHP’s GD extension to render raster images (png, webp), even when Imagick is installed.Enable this when your server has Imagick installed but restricts its usage. Common restrictions include strict security policies such as ImageMagick security policy XML.
'force_gd' => true,
GD produces lower-quality raster output than Imagick and does not support all color operations. Leave this false unless you have a specific reason to bypass Imagick.

​
How defaults are applied

Config-driven defaults apply automatically when you use:
  • The QrCode facade — QrCode::generate(...)
  • The <x-qr-code> Blade component
  • Type-hinting Linkxtr\QrCode\Generator via Laravel’s service container
They do not apply when you instantiate the generator directly with new Generator() and omit the config array. In that case the package uses its hardcoded defaults.
Any method you chain on a per-call basis always overrides the config default for that call only. The config file is never mutated.
// config: 'format' => 'svg', 'size' => 400
// This call uses png at 200px; the config is unchanged.
QrCode::format('png')->size(200)->generate('https://example.com');