Laravel 8 Jetstream profile-photos not showing
Stefan Bogdanescu
Founder & Senior Architect · 2026-06-29
Title: Troubleshooting Laravel 8 Jetstream Profile Photos Not Showing
Your Laravel 8 application is running smoothly, but you're facing an issue with user profile photos not being displayed on the update-profile-information form using Jetstream. To help fix this problem, we will walk through some potential causes and solutions step by step.
1. Verify Your Storage Configuration: One of the most common issues occurs when your Laravel application is unable to locate or serve the correct profile photo. Ensure that you have configured the storage directory correctly. In your 'config/filesystems.php', make sure the public file configuration looks like this:
```
'public' => [
'driver' => 'local',
'root' => storage_path('/public/storage'), // This should be the path to your storage folder
'url' => env('APP_URL').'/public/storage/', // The URL to access your public files
'visibility' => 'public', // Allow other users to read and download files from this directory
],
```
2. Check Your User Model: Laravel Jetstream utilizes a user model called 'App\Models\User'. If you have customized this model, ensure that the profile_photo_url attribute or its equivalent is defined properly, and it corresponds to the path of your public storage folder. You can also create a new migration for updating the user table if needed:
```
php artisan make:migration add_profile_photos_column_to_users_table --table=users
```
3. Check Your Blade Template Code: Laravel Jetstream uses blade templates to render the user interface (UI). Verify that your code for displaying the profile photo is correct and consistent with the stored location:
```
```
4. Double-check Your Environment Variables: Make sure that your Laravel application is pointing to the correct storage path and that you've enabled proper file system visibility using the 'config/filesystems.php'. Additionally, check your environment variables for any discrepancies in URL configuration.
```
APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:6IJbdi+QYczKeLT7yOw3OgPsHucXn1KxVUb27hTQKpU=
APP_DEBUG=true
APP_URL=http://127.0.0.1:8000
```
5. Test Your Application and Database Connections: Ensure that your Laravel application can establish a successful connection with the database containing the user profiles, as well as check if the storage directory exists on the specified path. You can use debugging tools such as artisan tinker to interact directly with your models.
6. Clear Cache and Recompile Assets: Finally, clear your cache to ensure that all necessary assets are recompiled. Run the following commands in your Laravel application:
```
php artisan cache:clear
npm install
npm run dev
```
By following these steps, you will be able to troubleshoot and resolve the issue with profile photos not showing up in Laravel 8 Jetstream. If the problem persists, consider seeking support from experienced developers on forums like the Laravel Community or Laracasts.