Instagram error 1: Thumbnail offset out of range (2207057)
Last verified against Meta for Developers - Messenger Platform error codes
Thumbnail offset must be greater than or equal to 0 and less than video duration, i.e. {video-length}What error 1 means
Code 1 usually means an unknown error, but with subcode 2207057 it is very specific: the thumb_offset you sent does not land inside the video. Meta's recommended solution is to supply the right offset, in milliseconds, within the video's duration. The message reports the video length so you know the valid range.
thumb_offset is optional on video and reel containers and picks the frame used as the cover thumbnail. It defaults to 0, the first frame. The value is in milliseconds, which is the root of most failures: an app that passes 15 meaning "15 seconds" is asking for a frame 15 milliseconds in, which is harmless, but one that passes 15000 for a 12-second clip, or computes the offset from a different, longer source file than the one uploaded, will be rejected.
For reels there is a simpler option. If you pass cover_url with an image, Meta uses it and ignores thumb_offset altogether.
What it looks like
{
"error": {
"type": "OAuthException",
"code": 1,
"error_subcode": 2207057,
"error_user_msg": "Thumbnail offset must be greater than or equal to 0 and less than video duration, i.e. 12480",
"fbtrace_id": "RsW4hPu2ZmCx6Di"
}
}Why it happens
- The offset was computed in seconds and then multiplied incorrectly, overshooting the duration.
- The offset was based on the original video, but a trimmed or transcoded version was uploaded.
- The offset is negative or equal to the full duration rather than strictly less.
- The duration was read from metadata that does not match the actual stream length.
How to fix Instagram error 1
- 1Read the video length in the error message and pick an offset from 0 up to just under it.
- 2Pass the value in milliseconds as an integer.
- 3Measure duration from the exact file you upload, after any trimming or transcoding.
- 4For reels, consider sending
cover_urlinstead, which overridesthumb_offset. - 5Create a new container with the corrected value.
How to stop it recurring
Compute and clamp thumb_offset server-side from the final uploaded file's duration, never from user input or the pre-transcode source. A cover frame picker in your UI should work in milliseconds end to end. Generic code-1 failures without this subcode are covered at code 1.
Official reference: Meta for Developers - Messenger Platform error codes. See all Instagram error codes or the Instagram limits and quotas.
Related codes
Error 1 - quick answers
What does Instagram error 1 mean?
Code 1 usually means an unknown error, but with subcode 2207057 it is very specific: the thumb_offset you sent does not land inside the video. Meta's recommended solution is to supply the right offset, in milliseconds, within the video's duration. The message reports the video length so you know the valid range. thumb_offset is optional on video and reel containers and picks the frame used as the cover thumbnail.
How do I fix Instagram error 1?
1. Read the video length in the error message and pick an offset from 0 up to just under it. 2. Pass the value in milliseconds as an integer. 3. Measure duration from the exact file you upload, after any trimming or transcoding. 4. For reels, consider sending cover_url instead, which overrides thumb_offset . 5. Create a new container with the corrected value.
Should I retry after error 1?
No. Retrying the same request produces the same error; the condition has to be fixed first. Treat it as a permanent failure for that message and surface it, rather than looping.
Stop debugging Instagram by hand
Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.