Search code examples

Email thumbnail URL changed to in gmail

I have a system whenever user upload an image, it will send an email to the registered user's gmail. But in the email, i see something like this, the thumbnail is not viewable.

enter image description here

I inspect on the element, and found the src linked to this url:

Obviously it is being cached by google proxy

But i can view the image without google user content, by accessing (i masked the domain so the image might not available to you).

I tried to clear browser cache but the problem still persist. How can i bypass the googleusercontent thingy or at least make the thumbnail able to display.

I checkout on this link Images not displayed for Gmail but im not using localhost and the image itself is accessible outside of my local network.


  • How does Google Image Proxy work

    The Google Image Proxy is a caching proxy server. Every time an image link is included in email the request will go to the Google Image Proxy first to see if it has been cached, if so it should serve it up from the proxy or it will go fetch it and cache it there after.

    The solution for most issues

    The Google Image Proxy server will fetch your images if this images:

    • have extensions like .png, .jpg/.jpeg or .gif only. May be .webp too. But not .svg.
    • do not use any kind of query string part in the image URL like ?id=123
    • have an URL which is mapped onto the image directly.
    • have not a long name.

    Requirements for image server:

    • The response from image server/proxy server must include the correct header like Content-Type: image/jpeg.
    • File extension and content-type header must be in the same type.
    • Status code in server response must be 200 instead of 403, 500 and etc.

    What could help too?

    Google support answer:

    Set up an image URL proxy whitelist

    When your users open email messages, Gmail uses Google’s secure proxy servers to serve images that might be included in these messages. This protects your users and domain against image-based security vulnerabilities.

    Because of the image proxy, links to images that are dependent on internal IPs and sometimes cookies are broken. The Image URL proxy whitelist setting lets you avoid broken links to images by creating and maintaining a whitelist of internal URLs that'll bypass proxy protection.

    When you configure the Image URL proxy whitelist, you can specify a set of domains and a path prefix that can be used to specify large groups of URLs. See the guidelines below for examples.

    Configure the Image URL proxy whitelist setting:

    • Sign in to your Google Admin console. Sign in using your administrator account (does not end in
    • From the Admin console Home page, go to Apps > G Suite > Gmail > Advanced settings. Tip: To see Advanced settings, scroll to the bottom of the Gmail page.
    • On the left, select your top-level organization.
    • Scroll to the Image URL proxy whitelist section.
    • Enter image URL proxy whitelist patterns. Matching URLs will bypass image proxy protection. See the guidelines below for more details and instructions.
    • At the bottom, click Save.

    It can take up to an hour for changes to propagate to user accounts. You can track prior changes under Admin console audit log.

    Guidelines for applying the Image URL proxy whitelist setting

    Security considerations

    Consult with your security team before configuring the Image URL proxy whitelist setting. The decision to bypass image proxy whitelist protection can expose your users and domain to security risks if not used with care.

    In general, if you have a domain that needs authentication via cookie, and if that domain is controlled by an administrator within your organization and is completely trusted, then whitelisting that URL should not expose your domain to image-based attacks.

    Important: Disabling the image proxy is not recommended. This option is available to provide flexibility for administrators, but disabling the image proxy can leave your users vulnerable to malicious attacks.

    Entering Image URL patterns

    To maintain a whitelist of internal URLs that'll bypass proxy protection, enter the image URL patterns in the Image URL proxy whitelist setting. Matching URLs will bypass the image proxy.

    A pattern can contain the scheme, the domain, and a path. The pattern must always have a forward slash (/) present between the domain and path. If the URL pattern specifies a scheme, then the scheme and the domain must fully match. Otherwise, the domain can partially match the URL suffix. For example, the pattern matches, but not The URL pattern can specify a path that's matched against the path prefix.

    Important: Enter your actual domain name as you enter the image URL pattern. Always include a trailing forward slash (/) after the domain name.

    Examples of Image URL patterns

    The following patterns are examples only. The following patterns:

    ... will match the following URLs:

    Note: The URL scheme (http://) is optional. If the scheme is omitted, the pattern can match any scheme, and allows partial matches on the domain suffix.

    Previewing the image URL patterns

    Click Preview to see if the URLs match the image URL patterns you've set. If the image URL matches a pattern, you'll see a confirmation message. If the image URL does not match, an error message appears.