Archive.org lets you set a custom thumbnail, but only before you publish

When you upload a file to Archive.org, the site generates a thumbnail automatically — usually a screenshot of the first page or frame. You cannot change this thumbnail after the item goes live. The only way to get a different thumbnail is to delete the upload and start over, or to contact Archive.org support and ask them to swap it for you, which takes time and is not may provide.

The practical path is to plan your thumbnail before you upload. If your file is a PDF, a video, or an image collection, you can control what Archive.org sees as the "first page" by arranging your files in a specific order or by uploading a cover image first. For websites and code projects, the thumbnail usually pulls from the page's Open Graph metadata — a set of tags you add to your HTML that tell any platform (Twitter, Facebook, Archive.org) what image to display when someone links to your work.

Key Takeaways

  • Archive.org generates thumbnails automatically from the first page or frame of your upload, and you cannot change it after publishing.
  • For PDFs and image collections, upload a cover image or arrange files so the one you want appears first.
  • For websites, add Open Graph meta tags to your HTML to tell Archive.org which image to use as the thumbnail.
  • If you have already published and want a different thumbnail, contact Archive.org support — they may swap it, but there is no may provide.
  • Testing your thumbnail before upload saves you from having to delete and re-upload your entire project.

How Archive.org chooses a thumbnail automatically

Archive.org scans your upload and picks the first visual element it finds. For a PDF, that is the first page. For a video file, that is the first frame. For a folder of images, that is whichever image appears first alphabetically or in upload order. For a website, it looks for an image tag or, if you have added them, Open Graph meta tags that specify an image.

The thumbnail appears on your item's detail page and in search results across Archive.org. A poor thumbnail — a blank page, a loading screen, a logo — makes your work less likely to be clicked on, even if the content is valuable. That is why controlling it matters.

Setting a thumbnail for PDFs and document uploads

If you are uploading a PDF or a collection of scanned pages, create a cover image and upload it as the first file. Archive.org will use it as the thumbnail. The cover should be a JPG or PNG, roughly 300 by 400 pixels, and should represent what is inside — a title page, a book cover, or a meaningful screenshot from the document.

Upload the cover image first, then upload the PDF or the rest of your files. Archive.org processes uploads in the order you add them, so the cover will be treated as the first item and will become the thumbnail. If you have already uploaded without a cover, you can delete the item and start over, or contact Archive.org support to ask them to manually set a different thumbnail.

Setting a thumbnail for video uploads

Archive.org uses the first frame of your video as the thumbnail. If that frame is black, a slate, or unrepresentative, you have two options: re-encode the video so a better frame comes first, or upload a separate image file and ask Archive.org support to use it.

Re-encoding is the cleaner path if you have the tools. Use FFmpeg or a video editor to trim a few seconds from the beginning of your video and replace them with a still image or a title card that shows what the video contains. Then upload the edited version. Archive.org will grab the first frame of the new file as the thumbnail.

Using Open Graph tags to control thumbnails for websites

If you are uploading a website or a web project, add Open Graph meta tags to the HTML of your home page or index file. These tags tell Archive.org (and social media platforms) which image to display as the thumbnail. Open Graph is a standard that any platform respects, so the same tags work everywhere.

Add these lines inside the <head> section of your HTML, replacing the example values with your own:

<meta property="og:image" content="https://yoursite.com/thumbnail.jpg"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="630"> <meta property="og:title" content="Your Project Title"> <meta property="og:description" content="A brief description of your project">

The image file should be a JPG or PNG, at least 1200 by 630 pixels, and should be hosted on a web server that Archive.org can reach. When Archive.org crawls your site, it will read these tags and use the image you specified as the thumbnail. Test this before uploading by using the Open Graph debugger tool on Facebook's developer site — it will show you exactly what image Archive.org will see.

What to do if you have already uploaded without a custom thumbnail

If your item is already live on Archive.org and the thumbnail is wrong, you have three options. The first is to delete the item and upload it again with the correct thumbnail in place. This works, but you lose any metadata, descriptions, or links people may have created to the old version.

The second option is to contact Archive.org support through their help page and ask them to manually change the thumbnail. Include a link to your item and a description of what image you want to use. Support staff will review your request, but there is no may provide they will grant it — they prioritize requests for items with significant public value.

The third option is to leave it as is. If the content is strong, people will click through and discover it regardless of the thumbnail. The thumbnail matters most for discoverability in search results and on collection pages, so if your item is already getting traffic through direct links, a poor thumbnail is less of a problem.

Testing your thumbnail before you upload

Before you upload to Archive.org, test what the thumbnail will look like. For a website, use the Open Graph debugger tool at facebook.com/developers/tools/debug — paste your site's URL and it will show you the exact image Archive.org will grab. For a PDF or video, open the file yourself and look at the first page or frame. Ask yourself: would I click on this in a search result?

If the answer is no, fix it before uploading. Rename files so the right one comes first, add a cover image, re-encode your video, or add Open Graph tags to your HTML. A few minutes of planning now saves you from having to delete and re-upload later.

Frequently Asked Questions

Can I change the thumbnail after I have published my item?

Not directly. You can contact Archive.org support and ask them to manually change it, but they do not may provide approval. The reliable path is to delete the item and upload it again with the correct thumbnail in place.

What size should my thumbnail image be?

For Open Graph tags, use at least 1200 by 630 pixels. For cover images on PDFs, 300 by 400 pixels is standard. Archive.org will resize images to fit its display, so slightly larger is better than slightly smaller.

Does Archive.org read Open Graph tags from every page, or just the home page?

Archive.org reads the tags from the first page it crawls, usually your home page or index file. Make sure the tags are in the <head> section and that the image URL is absolute (starts with http or https), not relative.

What if my video is hosted on YouTube or Vimeo instead of uploaded directly?

Archive.org can embed videos from YouTube and Vimeo, and it will use the thumbnail from that platform. To change it, you would need to change the thumbnail on YouTube or Vimeo itself, then wait for Archive.org to re-crawl your page.

If I delete my item and re-upload it, will it have a new URL?

Yes. Archive.org generates a new URL for each upload. If people have linked to the old version, those links will break. For this reason, only delete and re-upload if the thumbnail is important enough to justify the lost links.