How to create a 360 spin

On this page

Sirv automatically creates a spin file when you upload a sequence of images. If you don't yet have a series of images, we recomment trusted experts for 360 turntables and 360 photo studios.

Spin creation rules

A spin file is automatically generated when you upload images with:

  • File names containing a sequence of ascending numbers
  • At least 8 images in the sequence (max 1000)

Image file names

Spin files are created with the file extension .spin, for example:


The .spin file name is determined from either the folder or file name:

  • Folder name - if there is one spin in a folder, it will take the name of the folder.
  • File name - if there are multiple spins in a folder, they will take the name of the images.

When the folder name is used, the image names are disregarded. For example, if you upload this set of images to a folder named "black-dress":


The following .spin file will be created:


When the spin file name is generated from the file name, the ascending digits in the file names are stripped from the .spin file name. For example, if you upload these 2 sets of images:

/dresses/black-dress-straight-01.jpg /dresses/black-dress-frills-01.jpg
/dresses/black-dress-straight-02.jpg /dresses/black-dress-frills-02.jpg
/dresses/black-dress-straight-03.jpg /dresses/black-dress-frills-03.jpg
/dresses/black-dress-straight-04.jpg /dresses/black-dress-frills-04.jpg
/dresses/black-dress-straight-05.jpg /dresses/black-dress-frills-05.jpg
/dresses/black-dress-straight-06.jpg /dresses/black-dress-frills-06.jpg
/dresses/black-dress-straight-07.jpg /dresses/black-dress-frills-07.jpg
/dresses/black-dress-straight-08.jpg /dresses/black-dress-frills-08.jpg
/dresses/black-dress-straight-09.jpg /dresses/black-dress-frills-09.jpg
/dresses/black-dress-straight-10.jpg /dresses/black-dress-frills-10.jpg
/dresses/black-dress-straight-11.jpg /dresses/black-dress-frills-11.jpg
/dresses/black-dress-straight-12.jpg /dresses/black-dress-frills-12.jpg

These two .spin files will be created:


You can tell Sirv to use the image file names instead of the folder name. To do this, right-click the folder and choose "Folder settings". Change the "Spin file name" option to "Generate from file names":

Spin file name options

Single row spin

The above example image names will create a single row spin - also known as a 360 spin. It can be dragged from left to right. It cannot be dragged up and down. Most spins are single row spins. Example:

Multi-row spin

Sirv can also generate multi-row spins - also known as 3D spins. They can be dragged up and down as well as left and right.

The first digits represent rows and the second represent columns. Drag this example up and down, as well as left to right:

Sirv always processes the first set of digits as the row and the second set as the column:

If you upload a sequence of images such as this:


Sirv will create a two-row spin with this name:


Best-practice file naming

Spins have lots of files so to help you manage them, we recommend placing C/c, R/r or S/s before each set of digits.

They signify:

R = Row
C = Column
S = Spin number

This naming rule may be useful for:

  • Descriptive file names - R and C let you instantly know what each set of digits represent.
  • Multiple product spins - S signifies when a single product/item has multiple spins (e.g. different colours of the same product).
  • Better collaboration - other team members can quickly understand what the digits represent.

For example, if you upload these two multi-row spins:

/trainers/adidas-r01-c01-s01.jpg /trainers/adidas-r01-c01-s02.jpg
/trainers/adidas-r01-c02-s01.jpg /trainers/adidas-r01-c02-s02.jpg
/trainers/adidas-r01-c03-s01.jpg /trainers/adidas-r01-c03-s02.jpg
/trainers/adidas-r01-c04-s01.jpg /trainers/adidas-r01-c04-s02.jpg
/trainers/adidas-r01-c05-s01.jpg /trainers/adidas-r01-c05-s02.jpg
/trainers/adidas-r01-c06-s01.jpg /trainers/adidas-r01-c06-s02.jpg
/trainers/adidas-r01-c07-s01.jpg /trainers/adidas-r01-c07-s02.jpg
/trainers/adidas-r01-c08-s01.jpg /trainers/adidas-r01-c08-s02.jpg
/trainers/adidas-r02-c01-s01.jpg /trainers/adidas-r02-c01-s02.jpg
/trainers/adidas-r02-c02-s01.jpg /trainers/adidas-r02-c02-s02.jpg
/trainers/adidas-r02-c03-s01.jpg /trainers/adidas-r02-c03-s02.jpg
/trainers/adidas-r02-c04-s01.jpg /trainers/adidas-r02-c04-s02.jpg
/trainers/adidas-r02-c05-s01.jpg /trainers/adidas-r02-c05-s02.jpg
/trainers/adidas-r02-c06-s01.jpg /trainers/adidas-r02-c06-s02.jpg
/trainers/adidas-r02-c07-s01.jpg /trainers/adidas-r02-c07-s02.jpg
/trainers/adidas-r02-c08-s01.jpg /trainers/adidas-r02-c08-s02.jpg

Sirv will create these 2 spins:


If you apply R and C references to your images but there is only 1 row or 1 column, those digits won't change in your file names. Therefore, Sirv won't strip them from the file name.

For example, this 1-row spin:


Will produce this spin file:


If you wish to strip superfluous R01 or C01 entries in your .spin file names, either right-click and use "Rename" to change the name or contact Sirv support from your control panel and request for R01 or C01 to be automatically stripped.

Custom spin detection

If you use an image naming format that is not detected by default, Sirv offers custom spin detection algorithms for Enterprise accounts. Continue using your existing file naming convention and Sirv will be customized to fit that convention. Please contact support with your requirements.

Replacing images in a spin

If you upload one or more images with the same file name, the existing images will be overwritten and the cached spin images will be immediately invalidated. The next time the spin is requested through the browser, it will be recreated using the latest images.

Corrupt or missing images

A spin will be created even if one or more images are missing or corrupt.

Sirv will detect the missing/corrupt image and skip it when the spin rotates.

A corrupt image notification will show on the Notifications page of your Sirv account. You should re-upload such images.

Technical explanation of spin files

From a technical perspective, spin files are JSON text files. They list the images to be included in your spin animation, plus any other settings or hotspots that you wish to apply.

.spin files can be visited directly in your browser and the spin will load. They can also be shared on social media.

Was this article helpful?

Get help from a Sirv expert

help ukraine help ukraine Powered by Ukrainian determination and British ingenuity

How can you support Ukraine