---
id: free-email-domains
version: "1.0.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# free-email-domains — A package containing a list of free email domains.

License: permissive · Maintenance: active · Downloads: 2.4M/mo

## What it is and what it does

free-email-domains is a lightweight Python package that bundles a curated list of free email provider domains and exposes it as a simple membership-checkable collection. It solves the common problem of distinguishing free email addresses from corporate or custom domains in validation workflows—useful when you want to flag or filter signups, enforce domain policies, or segment users by email provider type.

The package has zero runtime dependencies, installs as a pure Python wheel, and is actively maintained. You import a single whitelist object and check domain membership directly. It's designed for straightforward use cases where you need quick, offline domain classification without external API calls.

Use it for:

- Filter user signups to require corporate email addresses and reject free providers during registration.
- Segment analytics or reporting by email provider type (free vs. enterprise domain).
- Validate email domains in bulk data processing pipelines where you need to flag free-provider addresses.
- Build email domain policies that treat free and corporate addresses differently in access control.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a curated list of free email domains that you can check membership against in your code.

Yes, if you need offline free-email-domain classification. The package is lightweight, dependency-free, actively maintained, and MIT-licensed. Install it when domain-based email filtering is a core requirement; skip it if you only occasionally need this check or prefer an external API.

## Install

pip install free-email-domains
uv add free-email-domains
poetry add free-email-domains

## Installing free-email-domains

Before you install: Low install friction with no runtime dependencies. Active maintenance as of 2026-02-23, though the repository has modest visibility with 8 stars.

License in practice: MIT License permits free use, modification, and distribution with minimal restrictions—suitable for both open and proprietary projects.

Quickstart:

pip install free-email-domains

from free_email_domains import whitelist

if 'gmail.com' in whitelist:
    print("Free email domain")

Verify before relying:

- How frequently the domain list is updated and whether it covers all major free providers globally.
- Whether the whitelist is exposed as a set, list, or other collection type that affects lookup performance.
- The exact size and composition of the domain list included in version 1.0.2.

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 2.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

free email domain list, check if email is free provider, email domain whitelist, identify free email addresses, email provider classification, email-validation, domain-list

[View on SkillFed](https://skillfed.io/packages/free-email-domains) · [View on PyPI](https://pypi.org/project/free-email-domains/)