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