# Release Notes

## [Unreleased](https://github.com/laravel/socialite/compare/v5.26.0...5.x)

## [v5.26.0](https://github.com/laravel/socialite/compare/v5.25.0...v5.26.0) - 2026-03-24

* Remove redundant "When to Apply" section from skill body by [@pushpak1300](https://github.com/pushpak1300) in https://github.com/laravel/socialite/pull/766
* [5.x] Fix workflow YAML syntax and clean up broken CI matrix by [@JoshSalway](https://github.com/JoshSalway) in https://github.com/laravel/socialite/pull/769

## [v5.25.0](https://github.com/laravel/socialite/compare/v5.24.3...v5.25.0) - 2026-02-27

* Add Boost skill for Socialite development by [@pushpak1300](https://github.com/pushpak1300) in https://github.com/laravel/socialite/pull/763
* Rename Boost skill directory to socialite-development by [@pushpak1300](https://github.com/pushpak1300) in https://github.com/laravel/socialite/pull/76

## [v5.24.3](https://github.com/laravel/socialite/compare/v5.24.2...v5.24.3) - 2026-02-21

* Laravel 13.x Compatibility by [@laravel-shift](https://github.com/laravel-shift) in https://github.com/laravel/socialite/pull/762

## [v5.24.2](https://github.com/laravel/socialite/compare/v5.24.1...v5.24.2) - 2026-01-10

* Fix FakeProvider to preserve decorator pattern when forwarding calls by [@mohammedmanssour](https://github.com/mohammedmanssour) in https://github.com/laravel/socialite/pull/760

## [v5.24.1](https://github.com/laravel/socialite/compare/v5.24.0...v5.24.1) - 2026-01-01

* Remove redundant `email` mapping causing error for unconfirmed X accounts by [@Gertiozuni](https://github.com/Gertiozuni) in https://github.com/laravel/socialite/pull/757
* chore: update firebase/php-jwt package by [@itsalifadaei](https://github.com/itsalifadaei) in https://github.com/laravel/socialite/pull/758

## [v5.24.0](https://github.com/laravel/socialite/compare/v5.23.2...v5.24.0) - 2025-12-09

* Add Testing Fakes by [@stevebauman](https://github.com/stevebauman) in https://github.com/laravel/socialite/pull/756

## [v5.23.2](https://github.com/laravel/socialite/compare/v5.23.1...v5.23.2) - 2025-11-21

* [5.x] PHP 8.5 Compatibility by [@crynobone](https://github.com/crynobone) in https://github.com/laravel/socialite/pull/755

## [v5.23.1](https://github.com/laravel/socialite/compare/v5.23.0...v5.23.1) - 2025-10-27

**Full Changelog**: https://github.com/laravel/socialite/compare/v5.23.0...v5.23.1

## [v5.23.0](https://github.com/laravel/socialite/compare/v5.22.0...v5.23.0) - 2025-07-23

* Fix the Facebook avatar URL by [@joaopms](https://github.com/joaopms) in https://github.com/laravel/socialite/pull/750
* Update Facebook Graph API version to v23.0 by [@joaopms](https://github.com/joaopms) in https://github.com/laravel/socialite/pull/749

## [v5.22.0](https://github.com/laravel/socialite/compare/v5.21.0...v5.22.0) - 2025-07-08

* Fix return type for functions which make use of json_decode by [@michaelklopf](https://github.com/michaelklopf) in https://github.com/laravel/socialite/pull/745
* feat(google): stateless ID token support by [@beefsack](https://github.com/beefsack) in https://github.com/laravel/socialite/pull/748

## [v5.21.0](https://github.com/laravel/socialite/compare/v5.20.0...v5.21.0) - 2025-05-19

* Added email and it's scope to TwitterProvider by [@abdulmejidshemsuawel](https://github.com/abdulmejidshemsuawel) in https://github.com/laravel/socialite/pull/744

## [v5.20.0](https://github.com/laravel/socialite/compare/v5.19.0...v5.20.0) - 2025-04-21

* Update logo by [@iamdavidhill](https://github.com/iamdavidhill) in https://github.com/laravel/socialite/pull/741
* Added email to X provider by [@maicol07](https://github.com/maicol07) in https://github.com/laravel/socialite/pull/742

## [v5.19.0](https://github.com/laravel/socialite/compare/v5.18.0...v5.19.0) - 2025-03-27

* docs: sync readme with recent adapters by [@iBotPeaches](https://github.com/iBotPeaches) in https://github.com/laravel/socialite/pull/735
* [5.x] Throw exception if config is incomplete by [@mateusjatenee](https://github.com/mateusjatenee) in https://github.com/laravel/socialite/pull/736
* Supports PHPStan 1.12 by [@crynobone](https://github.com/crynobone) in https://github.com/laravel/socialite/pull/739

## [v5.18.0](https://github.com/laravel/socialite/compare/v5.17.1...v5.18.0) - 2025-02-11

* Update facade PHPDoc by [@osbre](https://github.com/osbre) in https://github.com/laravel/socialite/pull/731
* Twitch by [@taylorotwell](https://github.com/taylorotwell) in https://github.com/laravel/socialite/pull/732

## [v5.17.1](https://github.com/laravel/socialite/compare/v5.17.0...v5.17.1) - 2025-01-28

* Supports Laravel 12 by [@crynobone](https://github.com/crynobone) in https://github.com/laravel/socialite/pull/730

## [v5.17.0](https://github.com/laravel/socialite/compare/v5.16.1...v5.17.0) - 2025-01-17

* Add "email_verified" to linkedin openid by [@aalyusuf](https://github.com/aalyusuf) in https://github.com/laravel/socialite/pull/725
* [5.x] Adds support for configuring Access Scope for providers from configuration by [@TheAladeen](https://github.com/TheAladeen) in https://github.com/laravel/socialite/pull/728
* [5.x] Added 2 additional tests for GitHub driver programmatic scope merging and overwriting by [@TheAladeen](https://github.com/TheAladeen) in https://github.com/laravel/socialite/pull/729

## [v5.16.1](https://github.com/laravel/socialite/compare/v5.16.0...v5.16.1) - 2024-12-11

* Update logo to support dark/light theme by [@milewski](https://github.com/milewski) in https://github.com/laravel/socialite/pull/717
* [5.x] Support PHP 8.4 by [@crynobone](https://github.com/crynobone) in https://github.com/laravel/socialite/pull/722

## [v5.16.0](https://github.com/laravel/socialite/compare/v5.15.1...v5.16.0) - 2024-09-03

* Add X Provider by [@tomocrafter](https://github.com/tomocrafter) in https://github.com/laravel/socialite/pull/712

## [v5.15.1](https://github.com/laravel/socialite/compare/v5.15.0...v5.15.1) - 2024-06-28

* Check if some fields exist using limited login by [@CosmicodeStudio](https://github.com/CosmicodeStudio) in https://github.com/laravel/socialite/pull/709

## [v5.15.0](https://github.com/laravel/socialite/compare/v5.14.0...v5.15.0) - 2024-06-11

* Support the custom parameters of the access token request by [@maximepvrt](https://github.com/maximepvrt) in https://github.com/laravel/socialite/pull/707

## [v5.14.0](https://github.com/laravel/socialite/compare/v5.13.2...v5.14.0) - 2024-05-03

* Update Socialite Providers URL by [@DamianKRTurner](https://github.com/DamianKRTurner) in https://github.com/laravel/socialite/pull/703
* [5.x] Add Slack OpenID provider by [@maartenpaauw](https://github.com/maartenpaauw) in https://github.com/laravel/socialite/pull/704

## [v5.13.2](https://github.com/laravel/socialite/compare/v5.13.1...v5.13.2) - 2024-04-26

* Update Socialite.php by [@adic3x](https://github.com/adic3x) in https://github.com/laravel/socialite/pull/701

## [v5.13.1](https://github.com/laravel/socialite/compare/v5.13.0...v5.13.1) - 2024-04-24

* Correct issue with GoogleProvider getUserByToken() method by [@ChengKaiChiang](https://github.com/ChengKaiChiang) in https://github.com/laravel/socialite/pull/700

## [v5.13.0](https://github.com/laravel/socialite/compare/v5.12.1...v5.13.0) - 2024-04-15

* Support OIDC token in Facebook provider (Facebook Limited Login) by [@gdebrauwer](https://github.com/gdebrauwer) in https://github.com/laravel/socialite/pull/698

## [v5.12.1](https://github.com/laravel/socialite/compare/v5.12.0...v5.12.1) - 2024-02-16

* Revert "Adding basic authentication by default on signed routes (#684)" by [@driesvints](https://github.com/driesvints) in https://github.com/laravel/socialite/pull/694

## [v5.12.0](https://github.com/laravel/socialite/compare/v5.11.0...v5.12.0) - 2024-02-11

* [5.x] Adding basic authentication by default on signed routes by [@moufmouf](https://github.com/moufmouf) in https://github.com/laravel/socialite/pull/684
* Correct issue with Google refreshToken() method by [@iBotPeaches](https://github.com/iBotPeaches) in https://github.com/laravel/socialite/pull/686
* Correct issue with GoogleProvider getUserByToken() method by [@alibori](https://github.com/alibori) in https://github.com/laravel/socialite/pull/689

## [v5.11.0](https://github.com/laravel/socialite/compare/v5.10.0...v5.11.0) - 2023-12-02

* [5.x] Add `refreshToken` method by [@antoinelame](https://github.com/antoinelame) in https://github.com/laravel/socialite/pull/675
* Adds L11 support by [@nunomaduro](https://github.com/nunomaduro) in https://github.com/laravel/socialite/pull/676

## [v5.10.0](https://github.com/laravel/socialite/compare/v5.9.1...v5.10.0) - 2023-10-30

- Update avatar and originalAvatar display size check by [@luigitec](https://github.com/luigitec) in https://github.com/laravel/socialite/pull/671
- Update LinkedInProvider.php by [@moha-ep](https://github.com/moha-ep) in https://github.com/laravel/socialite/pull/670

## [v5.9.1](https://github.com/laravel/socialite/compare/v5.9.0...v5.9.1) - 2023-09-07

- (feat) Extract some logic to a `userInstance` method. by [@lucasmichot](https://github.com/lucasmichot) in https://github.com/laravel/socialite/pull/663

## [v5.9.0](https://github.com/laravel/socialite/compare/v5.8.1...v5.9.0) - 2023-09-05

- [5.x] Include GitHub `node_id` field by [@lucasmichot](https://github.com/lucasmichot) in https://github.com/laravel/socialite/pull/657
- [5.x] Adds `LinkedInOpenId` provider by [@nunomaduro](https://github.com/nunomaduro) in https://github.com/laravel/socialite/pull/662

## [v5.8.1](https://github.com/laravel/socialite/compare/v5.8.0...v5.8.1) - 2023-08-21

- Fix phpstan issues in Twitter and Slack drivers by [@alecpl](https://github.com/alecpl) in https://github.com/laravel/socialite/pull/653

## [v5.8.0](https://github.com/laravel/socialite/compare/v5.7.0...v5.8.0) - 2023-07-14

- Update Slack provider to use v2 API and allow Bot tokens by [@jbrooksuk](https://github.com/jbrooksuk) in https://github.com/laravel/socialite/pull/645

## [v5.7.0](https://github.com/laravel/socialite/compare/v5.6.3...v5.7.0) - 2023-07-08

- Add support for Slack driver by [@jbrooksuk](https://github.com/jbrooksuk) in https://github.com/laravel/socialite/pull/644

## [v5.6.3](https://github.com/laravel/socialite/compare/v5.6.2...v5.6.3) - 2023-06-06

- Add buildProvider method on DockBlock for IDE  support by @emrancu in https://github.com/laravel/socialite/pull/643

## [v5.6.2](https://github.com/laravel/socialite/compare/v5.6.1...v5.6.2) - 2023-05-29

- Fix unable to use updated config object when using Laravel Octane by @aprokopenko in https://github.com/laravel/socialite/pull/639

## [v5.6.1](https://github.com/laravel/socialite/compare/v5.6.0...v5.6.1) - 2023-01-20

### Fixed

- Add app property by @driesvints in https://github.com/laravel/socialite/pull/621

## [v5.6.0](https://github.com/laravel/socialite/compare/v5.5.8...v5.6.0) - 2023-01-13

### Added

- Laravel v10 Support by @driesvints in https://github.com/laravel/socialite/pull/618

## [v5.5.8](https://github.com/laravel/socialite/compare/v5.5.7...v5.5.8) - 2023-01-05

### Fixed

- Fix User return types by @antoinelame in https://github.com/laravel/socialite/pull/614

## [v5.5.7](https://github.com/laravel/socialite/compare/v5.5.6...v5.5.7) - 2022-12-28

### Fixed

- Fixed string type issue by @driesvints in https://github.com/laravel/socialite/commit/295a36648828f0419c1e9cbedd97609d2a4cb211

## [v5.5.6](https://github.com/laravel/socialite/compare/v5.5.5...v5.5.6) - 2022-11-08

### Changed

- PHP 8.2 support by @driesvints in https://github.com/laravel/socialite/pull/607

## [v5.5.5](https://github.com/laravel/socialite/compare/v5.5.4...v5.5.5) - 2022-08-20

### Changed

- Add ability to override access token request headers by @JasonTolliver in https://github.com/laravel/socialite/pull/603

## [v5.5.4](https://github.com/laravel/socialite/compare/v5.5.3...v5.5.4) - 2022-08-08

### Fixed

- Add correct encoding and the required state param by @xhezairbey in https://github.com/laravel/socialite/pull/599

## [v5.5.3](https://github.com/laravel/socialite/compare/v5.5.2...v5.5.3) - 2022-07-18

### Fixed

- Add Twitter OAuth 2 fallback call by @driesvints in https://github.com/laravel/socialite/pull/596

## [v5.5.2](https://github.com/laravel/socialite/compare/v5.5.1...v5.5.2) - 2022-03-15

### Changed

- Allow OAuth version in the Twitter config by @taylorotwell ([68afb03](https://github.com/laravel/socialite/commit/68afb03259b82d898c68196cbcacd48596a9dd72))

## [v5.5.1](https://github.com/laravel/socialite/compare/v5.5.0...v5.5.1) - 2022-02-08

### Fixed

- Override abstract provider for Twitter's OAuth 2.0 provider ([#576](https://github.com/laravel/socialite/pull/576))

## [v5.5.0](https://github.com/laravel/socialite/compare/v5.4.0...v5.5.0) - 2022-02-01

### Changed

- add/set approvedScopes in User ([#572](https://github.com/laravel/socialite/pull/572))

## [v5.4.0 (2022-01-25)](https://github.com/laravel/socialite/compare/v5.3.0...v5.4.0)

### Added

- Add Twitter OAuth2 provider ([#574](https://github.com/laravel/socialite/pull/574))

## [v5.3.0 (2022-01-12)](https://github.com/laravel/socialite/compare/v5.2.6...v5.3.0)

### Changed

- Laravel 9 Support ([#571](https://github.com/laravel/socialite/pull/571))

## [v5.2.6 (2021-12-07)](https://github.com/laravel/socialite/compare/v5.2.5...v5.2.6)

### Fixed

- Fix PHP 8.1 issues ([#567](https://github.com/laravel/socialite/pull/567))

## [v5.2.5 (2021-08-31)](https://github.com/laravel/socialite/compare/v5.2.4...v5.2.5)

### Changed

- Make `enablePKCE` public ([#550](https://github.com/laravel/socialite/pull/550))

## [v5.2.4 (2021-08-10)](https://github.com/laravel/socialite/compare/v5.2.3...v5.2.4)

### Changed

- Handle 'scope' for Twitter Oauth1 ([#548](https://github.com/laravel/socialite/pull/548))

## [v5.2.3 (2021-04-06)](https://github.com/laravel/socialite/compare/v5.2.2...v5.2.3)

### Changed

- Add reset methods for Octane ([07840c0](https://github.com/laravel/socialite/commit/07840c07e7b5cf20bb31f8bc2332776a2411695e))

## [v5.2.2 (2021-03-02)](https://github.com/laravel/socialite/compare/v5.2.1...v5.2.2)

### Fixed

- Update provider to use DeferrableProvider instead ([#529](https://github.com/laravel/socialite/pull/529))

## [v5.2.1 (2021-02-22)](https://github.com/laravel/socialite/compare/v5.2.0...v5.2.1)

### Fixed

- Make PKCE opt-in ([#523](https://github.com/laravel/socialite/pull/523))

## [v5.2.0 (2021-02-16)](https://github.com/laravel/socialite/compare/v5.1.3...v5.2.0)

### Added

- Add support for OAuth 2.0 PKCE extension ([#518](https://github.com/laravel/socialite/pull/518))

## [v5.1.3 (2021-01-05)](https://github.com/laravel/socialite/compare/v5.1.2...v5.1.3)

### Added

- Added support for self hosted Gitlab instances ([#510](https://github.com/laravel/socialite/pull/510))

### Fixed

- Fix scope separator in Gitlab provider ([#512](https://github.com/laravel/socialite/pull/512))

## [v5.1.2 (2020-12-04)](https://github.com/laravel/socialite/compare/v5.1.1...v5.1.2)

### Security

- Revert Facebook picture access token changes ([#504](https://github.com/laravel/socialite/pull/504))

## [v5.1.1 (2020-11-24)](https://github.com/laravel/socialite/compare/v5.1.0...v5.1.1)

### Changed

- Cache User instance to allow `$provider->user()` to be called multiple times ([#498](https://github.com/laravel/socialite/pull/498))

## [v5.1.0 (2020-11-03)](https://github.com/laravel/socialite/compare/v5.0.3...v5.1.0)

### Added

- PHP 8 Support ([#495](https://github.com/laravel/socialite/pull/495))

## [v5.0.3 (2020-10-21)](https://github.com/laravel/socialite/compare/v5.0.2...v5.0.3)

### Fixed

- Include access token when requesting Facebook user profile photo ([#489](https://github.com/laravel/socialite/pull/489))

## [v5.0.2 (2020-10-20)](https://github.com/laravel/socialite/compare/v5.0.1...v5.0.2)

### Fixed

- Include `grant_type=authorization` code in token request parameters ([#488](https://github.com/laravel/socialite/pull/488))

## [v5.0.1 (2020-09-12)](https://github.com/laravel/socialite/compare/v5.0.0...v5.0.1)

### Fixed

- Fix bitbucket provider ([#475](https://github.com/laravel/socialite/pull/475))

## [v5.0.0 (2020-09-08)](https://github.com/laravel/socialite/compare/v4.4.1...v5.0.0)

### Added

- Add custom exceptions for providers of One ([#440](https://github.com/laravel/socialite/pull/440))
- Support Laravel 8 ([#465](https://github.com/laravel/socialite/pull/465), [#466](https://github.com/laravel/socialite/pull/466))

### Changed

- Only use the `read_user` scope for GitLab by default ([#403](https://github.com/laravel/socialite/pull/403))

### Removed

- Drop Laravel 5.7 support ([0bd64ae](https://github.com/laravel/socialite/commit/0bd64aefccf9b4d4dfee79ebe111003e392b1628))
- Drop Laravel 5.8 support ([4757ec4c](https://github.com/laravel/socialite/commit/4757ec4cc689e457fb161dd0afed4845a26cedff))
- Drop PHP 7.1 support ([6e21f1a](https://github.com/laravel/socialite/commit/6e21f1abdde6cd7a8deb4d5c1d2fb5d89dede6e7))

## [v4.4.1 (2020-06-03)](https://github.com/laravel/socialite/compare/v4.4.0...v4.4.1)

### Fixed

- Fix containter call ([#450](https://github.com/laravel/socialite/pull/450))

## [v4.4.0 (2020-06-02)](https://github.com/laravel/socialite/compare/v4.3.2...v4.4.0)

### Added

- Support Guzzle 7 ([#449](https://github.com/laravel/socialite/pull/449))

### Removed

- Remove guzzlehttp/guzzle ~5.0 workaround ([#448](https://github.com/laravel/socialite/pull/448))

## [v4.3.2 (2020-02-04)](https://github.com/laravel/socialite/compare/v4.3.1...v4.3.2)

### Fixed

- Use Authorization header for Github provider ([#430](https://github.com/laravel/socialite/pull/430))

## [v4.3.1 (2019-11-26)](https://github.com/laravel/socialite/compare/v4.3.0...v4.3.1)

### Fixed

- Override `SocialiteServiceProvider::isDeferred()` to mark as deferred ([#412](https://github.com/laravel/socialite/pull/412))

## [v4.3.0 (2019-11-19)](https://github.com/laravel/socialite/compare/v4.2.0...v4.3.0)

### Added

- Allow to manually set desired Facebook graph version ([#408](https://github.com/laravel/socialite/pull/408))

### Changed

- Change default Facebook graph version to 3.3 ([#408](https://github.com/laravel/socialite/pull/408))

## [v4.2.0 (2019-09-03)](https://github.com/laravel/socialite/compare/v4.1.4...v4.2.0)

### Added

- Laravel 6.0 support ([#390](https://github.com/laravel/socialite/pull/390))

## [v4.1.4 (2019-07-30)](https://github.com/laravel/socialite/compare/v4.1.3...v4.1.4)

### Changed

- Updated version constraints for Laravel 6.0 ([3fe71f1](https://github.com/laravel/socialite/commit/3fe71f1c593967e5b6046977b310e287f40ee92d))

## [v4.1.3 (2019-04-02)](https://github.com/laravel/socialite/compare/v4.1.2...v4.1.3)

### Fixed

- Fix bug with no LinkedIn email addresses ([#355](https://github.com/laravel/socialite/pull/355))

## [v4.1.2 (2019-03-15)](https://github.com/laravel/socialite/compare/v4.1.1...v4.1.2)

### Fixed

- Use proper key name for original avatar in Google Provider ([5ec0024](https://github.com/laravel/socialite/commit/5ec0024284d15df527376ced59b9e7b393f6f88b))

## [v4.1.1 (2019-03-12)](https://github.com/laravel/socialite/compare/v4.1.0...v4.1.1)

### Fixed

- Update Google API urls ([#346](https://github.com/laravel/socialite/pull/346))

## [v4.1.0 (2019-02-14)](https://github.com/laravel/socialite/compare/v4.0.3...v4.1.0)

### Added

- Laravel 5.8 support ([32b5ecf](https://github.com/laravel/socialite/commit/32b5ecf537648759bbb90dec8298424477c14f19))

### Fixed

- Handle Google responses excluding 'name' ([#340](https://github.com/laravel/socialite/pull/340))

## [v4.0.3 (2019-01-21)](https://github.com/laravel/socialite/compare/v4.0.2...v4.0.3)

### Fixed

- Use proper localized name ([#329](https://github.com/laravel/socialite/pull/329))

## [v4.0.2 (2019-01-21)](https://github.com/laravel/socialite/compare/v4.0.1...v4.0.2)

### Fixed

- Fix a bug with no LinkedIn image ([81adfcc](https://github.com/laravel/socialite/commit/81adfcc4f7df3a470cdab8a500db77c0de5d01a3))

## [v4.0.1 (2018-12-20)](https://github.com/laravel/socialite/compare/v4.0.0...v4.0.1)

### Fixed

- Fixed broken `GoogleProvider` ([#316](https://github.com/laravel/socialite/pull/316))

## [v4.0.0 (2018-12-18)](https://github.com/laravel/socialite/compare/v3.2.0...v4.0.0)

### Changed

- Removed support for PHP 7.0 ([#311](https://github.com/laravel/socialite/pull/311))
- Require Laravel 5.7 as minimum version ([#311](https://github.com/laravel/socialite/pull/311))

### Fixed

- Fixed and updated the broken LinkedIn provider ([#310](https://github.com/laravel/socialite/pull/310))
