Free Email Domains List

1.0.2 · active · verified Sun Apr 12

The `free-email-domains` package provides a comprehensive, curated list of free email domains from around the world, designed to simplify checking if an email address belongs to a free email provider. The current version, 1.0.2, was released on February 23, 2026, and is actively maintained with updates based on data from sources like HubSpot.

Warnings

gotcha This library only provides a list of common free email domains. It does NOT perform email address validation (e.g., checking for valid format, existence of domain, or deliverability) nor does it detect disposable/temporary email addresses, which are a different category of service.
Fix: Combine with a dedicated email validation library for robust checks, and consider a separate disposable email domain list if that functionality is required.
gotcha The `whitelist` is a curated list, primarily leveraging data from HubSpot. While comprehensive, it may not include every single free email provider globally, and new providers may emerge faster than the list is updated.
Fix: Review the source list if absolute comprehensiveness is critical. Contributions to update the list are welcomed by the maintainers.
gotcha For applications with high security requirements (e.g., user account systems), simply identifying a domain as 'not free' is insufficient for security. Domains can expire and be re-registered by malicious actors ('domain resurrection attacks'), potentially leading to account takeovers, as highlighted by PyPI's own security measures.
Fix: Implement multi-factor authentication (MFA) and consider additional security measures like verifying email deliverability or restricting registration from certain domains, regardless of their 'free' status.

Install

pip install free-email-domains Install with pip

Imports

whitelist
```
from free_email_domains import whitelist
```
The primary data structure is 'whitelist', a set of free email domains.

Quickstart

Import the `whitelist` set and check if a given email's domain exists within it.

from free_email_domains import whitelist

def check_email_domain(email_address):
    try:
        domain = email_address.split('@')[1]
        if domain in whitelist:
            print(f"'{domain}' is a free email domain.")
        else:
            print(f"'{domain}' is NOT a free email domain.")
    except IndexError:
        print(f"Invalid email address format: {email_address}")

check_email_domain("user@gmail.com")
check_email_domain("info@example.com")
check_email_domain("invalid-email")

view raw JSON →