# flask-session

> Server-side session support for Flask

- **URL**: https://www.freshcrate.ai/projects/flask-session
- **Author**: pypi
- **Category**: Frameworks
- **Latest version**: `0.8.0` (2026-04-21)
- **License**: Unknown
- **Source**: https://github.com/pallets-eco/flask-session/issues/
- **Homepage**: https://pypi.org/project/Flask-Session/
- **Language**: Python
- **GitHub**: 535 stars, 249 forks
- **Registry**: pypi (`flask-session`)
- **Tags**: `pypi`

## Description

.. image:: https://raw.githubusercontent.com/pallets-eco/flask-session/main/docs/_static/icon/favicon-192x192.png
    :alt: Flask-Session
    :target: https://flask-session.readthedocs.io
    :align: left
    :width: 60px

==============
Flask-Session
==============

Flask-Session is an extension for Flask that adds support for server-side sessions to
your application.

.. image:: https://img.shields.io/github/actions/workflow/status/pallets-eco/flask-session/test.yaml?logo=github
    :alt: GitHub Actions Workflow Status
    :target: https://github.com/pallets-eco/flask-session/actions/workflows/test.yaml?query=workflow%3ACI+branch%3Adevelopment

.. image:: https://img.shields.io/readthedocs/flask-session?logo=readthedocs
    :target: https://flask-session.readthedocs.io
    :alt: Documentation status

.. image:: https://img.shields.io/github/license/pallets-eco/flask-session?logo=bsd
    :target: ./LICENSE
    :alt: BSD-3 Clause License

.. image:: https://common-changelog.org/badge.svg
    :target: https://common-changelog.org
    :alt: Common Changelog
    
.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&label=style
    :target: https://github.com/astral-sh/ruff
    :alt: Code style: ruff

.. image:: https://img.shields.io/pypi/v/flask-session.svg?logo=pypi
    :target: https://pypi.org/project/flask-session
    :alt: PyPI - Latest Version

.. image:: https://img.shields.io/badge/dynamic/json?query=info.requires_python&label=python&logo=python&url=https%3A%2F%2Fpypi.org%2Fpypi%2Fflask-session%2Fjson
    :target: https://pypi.org/project/Flask-Session/
    :alt: PyPI - Python Version

.. image:: https://img.shields.io/discord/531221516914917387?logo=discord
    :target: https://discord.gg/pallets
    :alt: Discord

.. image:: https://img.shields.io/pypi/dm/flask-session?logo=pypi
    :target: https://pypistats.org/packages/flask-session
    :alt: PyPI - Downloads

Installing
------------
Install and update using pip:

.. code-block:: bash

    $ pip install flask-session

A Simple Example
--------------------

.. code-block:: python

    from flask import Flask, session
    from flask_session import Session

    app = Flask(__name__)
    # Check Configuration section for more details
    SESSION_TYPE = 'redis'
    app.config.from_object(__name__)
    Session(app)

    @app.route('/set/')
    def set():
        session['key'] = 'value'
        return 'ok'

    @app.route('/get/')
    def get():
        return session.get('key', 'not set')

Supported Storage Types
------------------------
- Redis
- Memcached
- FileSystem
- MongoDB
- SQLALchemy

Documentation
-------------
Learn more at the official `Flask-Session Documentation <https://flask-session.readthedocs.io/en/latest/>`_.

Maintainers
------------
- `Lxstr <https://github.com/Lxstr>`_
- Pallets Team

Contribute
----------
Thanks to all those who have contributed to Flask-Session. A full list can be found at `CONTRIBUTORS.md <https://github.com/pallets-eco/flask-session/blob/development/CONTRIBUTORS.md>`_.

If you want to contribute, please check the `CONTRIBUTING.rst <https://github.com/pallets-eco/flask-session/blob/development/CONTRIBUTING.rst>`_.

Donate
--------
The Pallets organization develops and supports Flask-Session and other popular packages. In order to grow the community of contributors and users, and allow the maintainers to devote more time to the projects, please donate today.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `0.8.0` | 2026-04-21 | Low | Imported from PyPI (0.8.0) |
| `0.7.0` | 2024-03-19 | Low | Changelog: [https://flask-session.readthedocs.io/en/latest/changes.html#id1](https://flask-session.readthedocs.io/en/latest/changes.html#id1) |
| `0.5.0` | 2023-05-11 | Low | This fixes compatibility with Flask 2.3.  Flask-Session has joined the Pallets Community Ecosystem, https://github.com/pallets-eco. Any community member interested in helping maintain this project may contribute by joining the `#flask-session` channel on https://discord.gg/pallets.  * Changes: https://flasksession.readthedocs.io/en/latest/changes.html#version-0-5-0 * Milestone: https://github.com/pallets-eco/flask-session/milestone/1?closed=1 |
| `0.4.1` | 2023-05-11 | Low | Version 0.4.1 was [already released to PyPI](https://pypi.org/project/Flask-Session/#history) on April 29, 2023. We are creating a release record here in GitHub while tagging it.  * Changes: https://flasksession.readthedocs.io/en/latest/changes.html#version-0-4-1 |
| `0.4.0` | 2023-05-11 | Low | Version 0.4.0 was [already released to PyPI](https://pypi.org/project/Flask-Session/#history) on June 24, 2021. We are creating a release record here in GitHub while tagging it.  * Changes: https://flasksession.readthedocs.io/en/latest/changes.html#version-0-4-0 |

## Citation

- HTML: https://www.freshcrate.ai/projects/flask-session
- Markdown: https://www.freshcrate.ai/projects/flask-session.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/flask-session/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._