Skip to main content

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.

Uploading a CSV file for jigsaws

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

ColumnDescription
Image urlDirect 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

ColumnDescription
RowsNumber of puzzle rows (auto-calculated based on image dimensions if not specified)
ColumnsNumber of puzzle columns (auto-calculated based on image dimensions if not specified)
Background colorPuzzle background color as hex code (e.g., #87CEEB) (chosen automatically if not specified)

Audio Settings

ColumnDescription
Connect sound urlSound when pieces connect
Scatter sound urlSound when pieces scatter

Puzzle Metadata

ColumnDescription
TitlePuzzle title
AuthorPuzzle author
Start messageMessage when puzzle starts
Pause messageMessage when puzzle is paused
End messageMessage 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

Download example CSV file