Laravel Breadcrumbs

Documentation

Troubleshooting

General

  • Re-read the documentation and make sure you did everything correctly
  • Start with the simple options and only use the advanced options (e.g. Route-Bound Breadcrumbs) once you understand how it works

Class 'Breadcrumbs' not found

  • Try running php artisan package:discover to ensure the service provider is detected by Laravel

Breadcrumb not found with name ...

  • Make sure you register the breadcrumbs in the right place (routes/breadcrumbs.php by default)
    • Try putting dd(__FILE__) in the file to make sure it's loaded.
    • Try putting dd($files) in BreadcrumbsServiceProvider::registerManager() to check the path is correct
    • If not, try running php artisan config:clear (or manually delete bootstrap/cache/config.php) or update the path(s) in config/breadcrumbs.php
  • Make sure the breadcrumb name is correct
    • If using Route-Bound Breadcrumbs, make sure it matches the route name
  • To suppress these errors when using Route-Bound Breadcrumbs (if you don't want breadcrumbs on some pages), either:
    • Register them with an empty closure (no push/parent calls), or
    • Set missing-route-bound-breadcrumb-exception to false in the config file to disable the check (but you won't be warned if you miss any pages)

BreadcrumbsServiceProvider Throws FileNotFoundException

  • Make sure the path is correct
  • If so, check the file ownership & permissions are correct
  • If not, try running php artisan config:clear (or manually delete bootstrap/cache/config.php) or update the path(s) in config/breadcrumbs.php

Undefined variable: breadcrumbs in view file

  • Make sure you use {{ Breadcrumbs::render() }} or {{ Breadcrumbs::view() }}, not @include()
    • If you do manually @include() a breadcrumbs view, ensure you pass the breadcrumb collection into it