Limites des en-têtes des messages Gmail

Cet article décrit les limites que Gmail applique aux en-têtes d'e-mail et indique les actions recommandées pour les respecter. Les en-têtes de message qui respectent les limites permettent d'assurer la bonne distribution des messages.

Les en-têtes d'e-mail fournissent des informations, ou des métadonnées, sur le message. Par exemple, les en-têtes d'e-mails contiennent des informations sur l'expéditeur, le destinataire et l'heure à laquelle le message a été envoyé.

Pour protéger les membres de votre organisation contre les e-mails malveillants, le spam ou les e-mails d'hameçonnage, Gmail bloque les messages dont les en-têtes dépassent les limites décrites ici. Les spammeurs et autres expéditeurs malveillants peuvent utiliser des en-têtes longs dans les messages pour usurper l'identité d'expéditeurs légitimes ou contourner les règles antispam.

Il arrive que des messages légitimes ou non malveillants contiennent des en-têtes très longs. Cela se produit généralement avec les appareils ou les systèmes qui envoient des e-mails automatiques. Les en-têtes de message personnalisés et les en-têtes "Objet" longs sont également à l'origine des en-têtes de message volumineux. Par exemple, si vous ajoutez le contenu d'un message à l'en-tête "Objet", celui-ci risque de dépasser la limite autorisée pour les en-têtes individuels.

Erreurs liées aux limites d'en-tête

Lorsque Gmail bloque un message dont les en-têtes dépassent une limite, il renvoie un message d'erreur SMTP à l'expéditeur. Le message décrit la limite qui a été dépassée. Consultez des exemples de messages d'erreur et les actions recommandées pour chacun d'eux dans la section Résoudre les problèmes liés aux erreurs d'en-tête de message ci-dessous.

Pour consulter tous les messages d'erreur SMTP Gmail, accédez à Erreurs et codes SMTP Gmail.

Limites des en-têtes des messages Gmail

Pour vous assurer que les messages sont correctement distribués, respectez ces limites pour les en-têtes de message. Ces limites s'appliquent également aux messages entrants.

Description Valeur maximale
Tous les en-têtes d'un même message 500 Ko
Nombre d'en-têtes par message 5000
Un seul en-tête

32 Ko (valeur après le deux-points)

Cette limite ne s'applique pas aux types d'en-têtes suivants : Cc, À ou Références. Toutefois, ces types d'en-têtes sont comptabilisés dans le total de tous les en-têtes d'un même message.

En-tête ID du message 500 caractères (caractères après le deux-points)
En-tête "Objet" 998 caractères (caractères après le deux-points)

Nom de l'en-tête

1 Ko (avant le deux-points)

Les types d'en-têtes qui dépassent cette limite sont généralement des en-têtes personnalisés comportant le préfixe "X" (par exemple, X-My-Custom-Header).

La valeur maximale autorisée après le deux-points est de 32 ko.

Résoudre les problèmes liés aux en-têtes de message

Si vos messages sortants sont rejetés parce que leurs en-têtes dépassent les limites fixées par Gmail, nous vous recommandons de prendre les mesures suivantes :

  • Tronquer les valeurs d'en-tête
  • Déplacer les informations d'en-tête dans le corps du message

Les valeurs affichées dans les messages d'erreur ci-dessous sont des exemples. Elles seront différentes dans les messages d'erreur que vous recevrez.

Message d'erreur Description et actions recommandées
552-5.3.4 L'en-tête de votre message dépasse la taille maximale autorisée par Google. Les messages ne doivent pas dépasser 512 000 octets d'en-tête au total ni 5 000 champs d'en-tête. Pour consulter nos consignes relatives à la taille, accédez à https://support.google.com/a?p=header-limits.

Le message inclut un en-tête qui dépasse la valeur maximale autorisée pour Nombre d'en-têtes par message ou pour Total de tous les en-têtes d'un même message.

Pour résoudre ce problème, déplacez certaines informations des en-têtes de message vers le corps du message.

552-5.3.4 La taille de la valeur de l'en-tête standard-header-type (32 769 octets) dépasse la limite de 32 768 octets par en-tête fixée par Google. Pour consulter nos consignes relatives à la taille, accédez à https://support.google.com/a?p=header-limits.

Un en-tête standard dépasse la taille maximale autorisée pour un en-tête (32 ko). Le message d'erreur indique l'en-tête qui est trop long.

Pour résoudre ce problème, tronquez cet en-tête lorsque de nouveaux messages sont créés. Si vous ne pouvez pas tronquer facilement cet en-tête, déplacez certaines informations de l'en-tête vers le corps du message.

552-5.3.4 La taille de l'une des valeurs d'en-tête (32 769 octets) dépasse la limite de 32 768 octets par en-tête fixée par Google. Pour consulter nos consignes relatives à la taille, accédez à https://support.google.com/a?p=header-limits.

Un en-tête non standard dépasse la taille maximale autorisée pour un en-tête, à savoir 32 ko. Pour protéger les informations potentiellement sensibles, nous n'incluons pas le nom de l'en-tête personnalisé dans le message d'erreur.

Pour résoudre ce problème, identifiez l'en-tête à l'origine de l'erreur et tronquez-le lorsque vous créez des messages.

552-5.3.4 La taille d'un nom d'en-tête (1 001 octets) dépasse la limite de 1 000 octets fixée par Google. Pour consulter nos consignes relatives à la taille, accédez à https://support.google.com/a?p=header-limits.

Le message contient un en-tête dont le nom dépasse la longueur maximale autorisée pour les noms d'en-tête (avant le deux-points).

Les types d'en-têtes qui dépassent cette limite sont généralement des en-têtes personnalisés. Pour résoudre ce problème, mettez à jour les en-têtes personnalisés afin qu'ils respectent la valeur maximale autorisée.