Options

Configuration Options

Option	Type	Description
sylius_invoicing.pdf_generator.enabled	config (YAML)	Turn PDF generation on/off.
sylius_invoicing.invoice_save_path	parameter	Directory where immutable invoice PDFs are stored.
WKHTMLTOPDF_PATH	env	Absolute path to the wkhtmltopdf binary if it’s not on PATH.
SYLIUS_INVOICING_LOGO_FILE	env	Path to your logo used in the PDF template.

Minimal configuration

# config/packages/sylius_invoicing.yaml
sylius_invoicing:
  pdf_generator:
    enabled: true

Environment & parameters

# .env.local
WKHTMLTOPDF_PATH=/usr/local/bin/wkhtmltopdf   # set if needed
SYLIUS_INVOICING_LOGO_FILE=path

# config/services.yaml (parameters section)
parameters:
  sylius_invoicing.invoice_save_path: '%kernel.project_dir%/var/invoices'

When are invoices created? By default, the plugin issues a new immutable invoice when the order reaches the created state. You can change when it happens via Symfony Workflow listeners (see “Extension Points → Symfony Workflow”). (GitHub)

Tips

• Ensure the save directory is writable by PHP (e.g., var/invoices/).

• Verify the binary: wkhtmltopdf --version (or the exact path you configured).

• Quick test: place an order and confirm a PDF appears in your save path; if not, check logs and your workflow trigger.