Identity Email

identity.email

Medium RiskCategory: CommunicationView Official Docs↗

⚠

Install Warning

"Know your email address."

Technical Context

Extends the identity permission to allow the extension to retrieve the user's Google account email address. This is used for personalization or account identification purposes.

What This Means For You

The extension can see your Google account email address. This is used for account identification but reveals your primary email to the extension.

Related APIs

This permission enables access to these Chrome APIs:

chrome.identity

Common Use Cases

✓Personalized services
✓Account management
✓User identification

How to Declare in manifest.json

Add the "identity.email" permission to your extension manifest:

{
  "manifest_version": 3,
  "name": "My Extension",
  "permissions": [
    "identity.email"
  ]
}

What Users Will See

When users install your extension, Chrome will display this warning:

⚠

This extension can:

"Know your email address."

Related Permissions

Native Messaging

nativeMessaging

The extension can talk to other programs installed on your computer, not just things in the browser. This is used by password managers and system utilities.

high

Runtime

runtime

This allows different parts of the extension to communicate with each other. It also enables the extension to respond when Chrome starts or when you click its icon.

low

Web Navigation

webNavigation

The extension can see when you navigate to different pages and how you got there, like clicking a link or using back/forward. It sees URLs as you browse.

high

Web Authentication Proxy

webAuthenticationProxy

The extension can intercept security key authentication requests. This is highly specialized and used for remote access to security keys.

high

Identity

identity

The extension can sign into services on your behalf using Google login or other authentication providers. By itself, it cannot see your email address.

low