free-email-domains

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 on this page — 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

free-email-domains on PyPI

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

Evidence: free_email_domains-1.0.2-py3-none-any.whl

Tags

More Utilities packages