Upload formats
Objective
Learn how you can upload jigsaw puzzle files.
PuzzleMe supports uploading jigsaw puzzles in .csv
format. A sample file is available on the PuzzleMe upload page.

You can also upload a CSV file to batch upload multiple jigsaw puzzles at once.
note
Bulk upload features are available based on your plan type. See our pricing page for plan details or contact support if you need access to bulk upload capabilities.
CSV Column Reference
Required Columns
Column | Description |
---|---|
Image url | Direct URL to your puzzle image |
CORS Issues
If the image cannot be accessed due to CORS (Cross-Origin Resource Sharing) issues, the upload will fail. For more information on resolving CORS issues, see our Static Resources CORS Setup guide.
Optional Columns
Puzzle Configuration
Column | Description |
---|---|
Rows | Number of puzzle rows (auto-calculated based on image dimensions if not specified) |
Columns | Number of puzzle columns (auto-calculated based on image dimensions if not specified) |
Background color | Puzzle background color as hex code (e.g., #87CEEB) (chosen automatically if not specified) |
Audio Settings
Column | Description |
---|---|
Connect sound url | Sound when pieces connect |
Scatter sound url | Sound when pieces scatter |
Puzzle Metadata
Column | Description |
---|---|
Title | Puzzle title |
Author | Puzzle author |
Start message | Message when puzzle starts |
Pause message | Message when puzzle is paused |
End message | Message when puzzle is completed |
Example CSV data:
Image url,Title,Author,Rows,Columns,Background color,Connect sound url,Start message,End message
https://exampleimage1.com,Sunset Beach,John Smith,4,6,#87CEEB,https://example.com/connect.mp3,Welcome to the puzzle!,Great job!
https://exampleimage2.com,Mountain View,Jane Doe,,,,,Ready to solve?,
https://exampleimage3.com,Forest Path,,
In this example:
- The first row is a puzzle with specified rows/columns and background color
- The second row is a puzzle using auto-calculated settings and default values
- The third row is a puzzle with only the required Image url column