GIF Loop Settings: Infinite, Play Once & Custom

Q: How do I stop a GIF from looping?

Set loop count to 1 (play once) or use gifsicle: gifsicle --loopcount=1 input.gif > output.gif. Browser behavior varies.

GIF Loop Settings:
Infinite, Play Once & Custom

GIF loop behavior is controlled by a simple number stored in the NETSCAPE2.0 application extension block. Set it to 0 for infinite looping, 1 for play-once, or any value up to 65,535 for custom loop counts. This guide explains how looping works, browser behavior differences, and practical recommendations.

GIF Loop Basics

The GIF format supports configurable loop behavior through the NETSCAPE2.0 Application Extension, added after the original GIF89a specification:

Loop count 0: infinite loop (plays forever). This is the default for most GIFs.
Loop count 1: play once and stop on the last frame.
Loop count N: play N times then stop. Maximum value is 65,535.
No extension: technically means play once, but behavior varies by viewer.

When to Use Each Setting

Loop Setting	Use Case	Examples
Infinite (0)	Continuous animations	Social media, memes, web content, messaging
Play once (1)	One-shot animations	Presentations, tutorials, instructions
2–3 times	Attention without annoyance	Email marketing, banner ads

Browser Behavior Differences

The GIF specification's loop count interpretation is ambiguous, and browsers handle it differently:

Chrome/Edge: loop count N means the animation plays a total of N+1 times (initial play plus N repeats). So loop=1 plays twice.
Firefox: loop count N means the animation plays exactly N times total. So loop=1 plays once.
Safari: similar to Firefox — N means N total plays.

This inconsistency means loop=1 plays either once or twice depending on the browser. For truly "play once" behavior that works everywhere, the safest approach is to test in your target browsers. For infinite looping (loop=0), all browsers behave identically.

Practical tip: If you need exactly-once playback, consider using loop=0 (infinite) with a longer pause on the last frame. This way the GIF appears to stop naturally while technically still looping.

How to Change Loop Count

When Creating a New GIF

In FFmpeg, use the -loop flag:

-loop 0 — infinite loop (default)
-loop 1 — play once
-loop 3 — play 3 times
-loop -1 — no loop (omit NETSCAPE extension entirely)

Modifying an Existing GIF

Use gifsicle to change the loop count without re-encoding:

gifsicle --loopcount=0 input.gif > infinite.gif
gifsicle --loopcount=1 input.gif > play_once.gif

Loop Count for Email Marketing

For email GIFs, loop count has special importance:

Infinite loops are distracting: a constantly moving GIF can annoy subscribers, especially in professional contexts
Play 2–3 times: catches attention initially, then stops. The subscriber can re-trigger by scrolling away and back.
Outlook ignores loops entirely: only shows the first frame regardless of loop settings
Design for both states: the GIF should look good both while animating and after stopping on the last frame

Frequently Asked Questions

How do I make a GIF play only once?

Set the loop count to 1 in your GIF creator. In FFmpeg, use -loop 1. In our converter, change the loop setting from "Infinite" to "Play Once."

How do I stop a GIF from looping?

Set loop count to 1 (play once) or use gifsicle on an existing GIF: gifsicle --loopcount=1 input.gif > output.gif. Note that browser behavior varies.

Why does my GIF loop differently in different browsers?

The GIF spec's loop count interpretation is ambiguous. Some browsers count the initial play plus N repeats, others count total plays as N. This is a known inconsistency.

What loop setting should I use for email GIFs?

Loop 2–3 times for email. This catches attention without being annoying. Remember that Outlook desktop shows only the first frame regardless of loop settings.