Zeplin Connectivity Issues: Not Loading or Not Connecting

How to fix it

Try these in order — the most common fix is first.

1. 1. Allowlist Zeplin domains

   Copy steps
   1. Add zeplin.io, app.zeplin.io, api.zeplin.io, img.zeplin.io, scene.zeplin.io, public.zeplin.io, pusher.zeplin.io, ws.zeplin.io, ext.zeplin.io, pkg.zeplin.io, cdn.zeplin.io, email.zeplin.io, zpl.io
   2. Also add ws-zeplin.pusher.com and zeplin.s3-accelerate.amazonaws.com
   3. For the macOS app also allow api.appcenter.ms and *.appcenter.ms
   Did this fix it? Yes No

2. 2. Fix real-time issues

   Copy steps
   1. Confirm the WSS (HTTPS) port is open
   2. Confirm your network permits WebSockets
   Did this fix it? Yes No

3. 3. Use IP allowlisting only if required

   Copy steps
   1. Allow AWS ranges for us-west-1, us-west-2 and us-east-1 from ip-ranges.amazonaws.com
   2. Expect it to break if IPs change
   3. Reload Zeplin and retest the web app, live updates and downloads
   Did this fix it? Yes No

Symptoms

Zeplin web or desktop app will not load, does not update in real time, or downloads fail on a corporate or filtered network.

Why it happens

• Firewall, proxy or filter blocks one or more Zeplin domains
• WSS port closed or WebSockets not allowed
• IP-only allowlisting breaks because Zeplin does not use static IPs

This guide also covers

• zeplin not loading
• zeplin connection error
• zeplin blocked firewall domains

The same problem in other apps

All not loading, error messages & connection guides →

• Figma Plugins Not Working or Won't Load (Figma)

Other Zeplin errors

• Zeplin "Your session has expired" Error
• Zeplin "Request failed: forbidden (403)" Error
• Zeplin "Request Timeout" Error on Export
• Zeplin Measurements Wrong: Half or Twice the Size
• Zeplin Figma Plugin Not Working or Won't Export
• Zeplin "Failed to Extract Installer" Error on Windows
• Zeplin Emails Not Arriving: Invites and Billing
• Zeplin Payment Failed: Credit Card Declined