{"id":4543,"library":"free-email-domains","title":"Free Email Domains List","description":"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.","status":"active","version":"1.0.2","language":"en","source_language":"en","source_url":"https://github.com/LukeRenton/free-email-domain-list","tags":["email","domain-validation","free-email","whitelist","email-verification"],"install":[{"cmd":"pip install free-email-domains","lang":"bash","label":"Install with pip"}],"dependencies":[],"imports":[{"note":"The primary data structure is 'whitelist', a set of free email domains.","symbol":"whitelist","correct":"from free_email_domains import whitelist"}],"quickstart":{"code":"from free_email_domains import whitelist\n\ndef check_email_domain(email_address):\n    try:\n        domain = email_address.split('@')[1]\n        if domain in whitelist:\n            print(f\"'{domain}' is a free email domain.\")\n        else:\n            print(f\"'{domain}' is NOT a free email domain.\")\n    except IndexError:\n        print(f\"Invalid email address format: {email_address}\")\n\ncheck_email_domain(\"user@gmail.com\")\ncheck_email_domain(\"info@example.com\")\ncheck_email_domain(\"invalid-email\")","lang":"python","description":"Import the `whitelist` set and check if a given email's domain exists within it."},"warnings":[{"fix":"Combine with a dedicated email validation library for robust checks, and consider a separate disposable email domain list if that functionality is required.","message":"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.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Review the source list if absolute comprehensiveness is critical. Contributions to update the list are welcomed by the maintainers.","message":"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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"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.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-12T00:00:00.000Z","next_check":"2026-07-11T00:00:00.000Z"}