Skip to the content
Photos and uploads

Photo requirements: formats, sizes and limits

Which 360 photos Panoramr accepts: file types, the 2:1 shape, size limits, how many per tour and per account, and what each way of adding a photo checks.

Reference6 min read Updated

On this page

The short version

Panoramr takes a 360 photo as a JPEG or TIFF file that is twice as wide as it is tall (2:1), or within 5% of that, or as six square cube-face files. A sphere can be up to 23,000 pixels wide. How many photos a tour and an account can hold depends on the plan.

The tour upload window

This is the panel on Create Tour (the page behind Create Tour and Create New Tour) and in the Add Panorama window, which Add Panoramr on the Tour tab, Upload Panoramrs on the Panoramrs tab and Add Panoramr in the Asset Library open. Replace Original File uses the same panel for one photo, with the same checks. The panel reads each file in your browser, before anything is sent, and the server checks again.

Rule What the panel accepts
File types JPEG (.jpg, .jpeg) and TIFF (.tif, .tiff), in capitals or not. The panel goes by the file's name and by its first bytes, so a PNG named .jpg is refused as a PNG. PNG, WebP, HEIC and every other kind of file are not taken.
Shape A sphere (an equirectangular photo) twice as wide as it is tall, for example 8192 × 4096. A photo that is not exactly 2:1 is still taken when its width divided by its height is between 1.9 and 2.1: it is fitted to the sphere, and its row says so. Or a cube: six square images of the same size, with names that end in _f, _b, _l, _r, _u and _d before the extension, such as kitchen_f.jpg. The part before the suffix must be the same in all six. A cube is taken on a computer only.
Largest size A sphere up to 23,000 pixels wide. A cube face up to 16,000 × 16,000 pixels. The panel enforces no smallest size.
File size No file is left out for how many megabytes it is. 250 MB or less works best: a larger one is still taken, but takes longer and needs a recent computer with plenty of memory. A JPEG export of the same photo is far smaller.
Camera data Read from JPEG files. A TIFF gives none.

A computer makes each photo into tiles in the browser. A phone or tablet, a browser that cannot make tiles, and a computer with too little memory for the photo send the photo to Panoramr's servers to be made instead, and the row says made on our servers with the reason. The servers take a sphere up to 16,384 pixels wide; a wider one is refused there with the most we can make on our servers is 16,384 px.

A file that cannot be used is never dropped without a word: it is listed in red, marked Can’t use, with its reason. In the Add Panorama window it is in the checked list, before you click Import Panoramas. On Create Tour, where photos start as soon as you choose them, it is at the top of the list until you click Hide. Fix upload problems lists the reasons.

How many photos you can add

Counted in panoramas, there is one number for the whole account, and nothing per tour:

Plan Held by the whole account
Free 250
Pro 1,000
Agency 3,600
Enterprise no limit set
  • Held by the whole account counts every panorama you own, in tours, in the Asset Library and in posts, plus the size of each Vault that is running. Panoramas in the trash do not count until you restore them. The panel says how many panoramas are left on your plan and adds only that many. If you choose more, the first ones are added: the checked list of the Add Panorama window says only N fit on your plan, and Create Tour leaves the rest out without a message.
  • One tour can hold all of it. There is no limit per tour. A tour goes online whole: in free publishing (250 panoramas in 10 tours), in your plan's hosting, or in a Vault sized for it. Adding photos to a tour that is already hosted or on Explore must fit the place it is in. See Free publishing, plan hosting or a Vault.

The plan that counts is the plan of the account that owns the tour. A Vault does not change your account's plan, but its size is added to what the account can hold.

If the server refuses a photo for a limit, its row is marked Failed and gives the server's reason: the account holds as many panoramas as the plan allows, the files of your panoramas fill the room the plan keeps for them, or the place the tour is hosted in (plan hosting, Explore or a Vault) has no room. Fix upload problems has each message.

Other ways to add a photo

Way in File types Shape and size How many
Replace Original File JPEG, TIFF As the tour upload window. One file replaces one scene. No count: a replacement does not add a panorama.
Create Post page (Select Image) JPEG, PNG, WebP Width divided by height between 1.9 and 2.1, measured after the photo is turned upright by its orientation tag, and at most 16,384 pixels wide. Up to 100,000 KB (about 100 MB). One per upload. The account limit above applies.
Create Tour, signed in or not JPEG, TIFF As the tour upload window. A file of 250 MB or less works best; a larger one is still taken and takes longer. Without an account, up to 20: you agree to the terms before you choose photos, and each photo goes into a guest tour as soon as it is ready. Signed in: what your account can still hold.

The Create Post page checks the shape in the browser first, and again on the server. A photo outside the range is refused with That does not look like a 360° panorama: it is 1000 × 1000, and a panorama is twice as wide as it is tall. Choose the full 360° photo your camera or app made. (the numbers are those of your file).

Floor plans, and the images, video, audio and documents you use in hotspots and menus, are not panoramas. They have their own rules.

Camera data and location

Camera facts such as make, model and exposure are read from JPEG files in your browser and shown on the Panoramrs tab under Camera Metadata (EXIF), in the Advanced view. The photo's GPS position, the artist, the copyright and the description are not shown there. The position is kept for you alone; Add a location to a panorama explains how it is used.

If a photo is refused

Read the reason on the photo's row, and check the file against the first table: its type, its shape and its size. Fix upload problems lists each message the panel and the server give and what to do about it.

Was this article helpful?