NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1744 most downloaded on PyPI
Python Social Authentication, Django integration.
Latest stable
8.1.0
Last release 10 days ago
12 Nov 2026
Release timing varies
gaps range from 9 days to 7 months
Nearly every release is documented
notes for 35 of 35 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
35 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Restrict default user-details pipeline saves and association data saves to changed fields so concurrent account changes are preserved.
app_launch to forward query parameters named in the new
SOCIAL_AUTH_APP_LAUNCH_FORWARDED_PARAMS setting to social:begin, such as
SAML idp or fields listed in SOCIAL_AUTH_FIELDS_STORED_IN_SESSION. The
iss, next, and CSRF token fields cannot be overridden.app_launch navigations from other subdomains or sites when their
Referer matches the new SOCIAL_AUTH_APP_LAUNCH_ALLOWED_ORIGINS setting.app_launch with backends that have no ID token issuer, such as
OAuth2 and SAML backends. These launches omit iss and reject a requested
iss; invalid issuer configuration is still rejected.app_launch navigations with Sec-Fetch-Site: none, which browsers
send for user-initiated navigations such as links opened from native apps.
Missing Fetch Metadata still requires a trusted Referer.app_launch instead of
redirecting them to next or LOGIN_REDIRECT_URL, so the bridge can link
accounts and reauthenticate like a login form. Applications that relied on
the redirect should check authentication before sending users to the bridge.
idp_launch still redirects signed-in users.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Support social-auth-core's SAML browser return page and its security headers, allowing callbacks to use the initiating browser's SameSite=Lax session
DjangoStrategy.get_session_id() and DjangoStrategy.restore_session().get_session_timeout() options keyword-only. Passenable_session_expiration and max_session_length by name in custom callers.Support Python 3.15 and Django 6.1.
get_title()Referer headers toSOCIAL_AUTH_MAX_SESSION_LENGTH.SOCIAL_AUTH_OLD_ID_KEYS overrides take precedence over backend detection;0 as a specific ID when disconnecting, preventingclearsocial, which now applies its --age retentionsocial:complete, preventing cross-site requests from startingImporting social_django.config now emits a deprecation warning. Use social_django.apps instead.
social_django.config now emits a deprecation warning. Usesocial_django.apps instead.SOCIAL_AUTH_OLD_ID_KEYS overrides for previous custom setups.Association.cleanup_expired() removes expired OpenID associations and OIDC nonces. The clearsocial command now includes this cleanup independently of
Association.cleanup_expired() removes expired OpenID associations and OIDC
nonces. The clearsocial command now includes this cleanup independently of
its --age option. Existing undated OIDC nonces receive a 30-minute grace
period during migration.
Strategy-based, opt-in synchronization of external memberships to existing
Django groups using backend-scoped GROUPS_MAP configuration.
Render an overridable authentication error page with an appropriate HTTP status
when exception middleware is installed without SOCIAL_AUTH_LOGIN_ERROR_URL.
Opt-in SOCIAL_AUTH_ERROR_INCLUDE_METADATA for safe code/source/stage/recovery
fields in error redirects, including message-storage fallback.
Backend display metadata in the backends.metadata template context and
social_django.finders.SocialAuthIconFinder for social-core's bundled SVGs.
Register the finder after Django's standard finders to collect the icons.
request_data() to get_request_data().strategy.request for the HTTP request and strategy.request_data() fordispatch_error() andappend_query_params() must accept the keyword-only metadata argument.USE_TZ=False. No migration is needed.UUIDField username,Use an explicit related field in the social authentication admin to avoid a Django 6.0 deprecation warning.
ErrorTransport.MESSAGES, ErrorTransport.QUERY) via SOCIAL_AUTH_ERROR_TRANSPORT to SocialAuthExceptionMiddleware.idp-launch/ and app-launch/) to re-enable GET initiation flows into CSRF-protected social:begin.Created sessions before authentication so cross-site SAML POST callbacks can restore authentication request IDs.
Added the default Django confirmation page for externally resumed partial pipelines.
SOCIAL_AUTH_REQUIRE_POST setting was removed.social-auth-core dependency to the next major release with the required Strategy hooks.Added async support to SocialAuthExceptionMiddleware
SocialAuthExceptionMiddlewaresocial-auth-core dependency to allow compatible 4.x releasesAdded explicit Django 5.1, 5.2, and 6.0 package classifiers
DjangoStrategy now lazily creates a session when initialized without a requestreplaces metadata from historical squashed migrationsunique_together migration declarations for newer Django compatibilityIntegrated with social_core using registry instead of monkey patching it
social_core using registry instead of monkey patching itThis project welcomes donations to make the development sustainable. The following platforms are available for funding Python Social Auth:
Fixed possibly unsafe account association (CVE-2025-61783)
SOCIAL_AUTH_ACTIVE_USERS_FILTER if your custom model does not have the is_active fieldRAISE_EXCEPTIONS and LOGIN_ERROR_URL can be configured per backendFixed authentication with OpenID based services
This project welcomes donations to make the development sustainable, you can fund Python Social Auth on the following platforms:
Dropped support for older Django versions.
uid.This project welcomes donations to make the development sustainable, you can fund Python Social Auth on the following platforms:
deps: Update supported Python versions by @a-grealish in #621
Full Changelog: 5.4.2...5.4.3
Full Changelog: https://github.com/python-social-auth/social-app-django/compare/5.4.2...5.4.3
Fixed UserSocialAuth creation by allowing JSONField to be blank
UserSocialAuth creation by allowing JSONField to be blankFull Changelog: 5.4.1...5.4.2
UserSocialAuth creation by allowing JSONField to be blankFull Changelog: https://github.com/python-social-auth/social-app-django/compare/5.4.1...5.4.2
UserSocialAuth creation by allowing JSONField to be blank0013_migrate_extra_data.pyFixed improper handling of case sensitivity with MySQL/MariaDB (CVE-2024-32879)
Improved JSON field migration performance
* Uses Django native JSON field
### Changed - Removed support for Django<3.2 - Fixed missing migration issue
Compatibility with recent Django and Python versions
Switch from deprecated django.conf.urls.url to django.urls.path
Changes:
django.conf.urls.url to django.urls.path.exists() instead of .count() > 0JSONField support, details documented here_default_manager instead of objectsDropped support for older Django versions (1.8, 1.9, 1.10, 2.0)
TypeError when continuing a pipeline in Django 2.1### Changed - Correct release mechanism
Updated release and tests mechanism
Updated JSONField.from_db_value signature to support multiple Django versions by accepting just the needed parameters.
JSONField.from_db_value signature to support multiple Django
versions by accepting just the needed parameters.Reduce log level of exceptions to INFO if messages app is installed
INFO if messages app is installedencodebytes if availableuser as keyword argument to do_completeusername when using email as usernamefield.relSocialAuthExceptionMiddlewareRemove call to deprecated method _get_val_from_obj()
urlquote since it handles unicode_get_val_from_obj()Better default when checking if the middleware should raise the exception
JSONField default value to dict callableauthenticate() parameters cleanup to avoid double arguments errorsJSONField support PostgreSQL builtin option if configuredCheck for a MAX_SESSION_LENGTH setting when logging in and setting session expiry.
MAX_SESSION_LENGTH setting when logging in and setting session expiry.on_cascade clauses to migrations.Authenticate cleanup method override to discard request parameter getting passed starting from Django 1.11
Remove migration replacement to nonexistent reference
Partial pipeline DB storage implementation
social_auth related name since it should be consider a simple helper.Let Django resolve URL when getting from settings (port of #905 by webjunkie)
REDIRECT_URL_VALUE value to be quoted by default.
Refs #875Split from the monolitic python-social-auth codebase
One column per quarter.