How to create a 360 spin
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)
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:
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":
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:
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:
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.
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:
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.
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.
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.
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.
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.