Skip to main content

Upload formats

Objective

Learn how you can upload jigsaw puzzle files.

PuzzleMe supports uploading jigsaw puzzles in .csv format. You can use CSV files to upload a single puzzle or multiple puzzles at once. CSV uploads let you control puzzle metadata, audio settings, and difficulty levels. A sample file is available on the PuzzleMe upload page.

Uploading a CSV file for jigsaws
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.

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​

Difficulty Levels​

You can create puzzles with up to three difficulty levels. Each level determines the number of pieces in a puzzle.

For information on adding difficulty levels in the puzzle editor, click here.

One level:

  • Auto-calculated: No headers needed. Just provide your Image url.
  • Custom: Include Rows and Columns headers and specify your values. Note: these columns don't have a level designation—they're just called Rows and Columns.

Two or three levels:

Include headers for each level you want:

  • Two levels: Rows, Columns, Rows (Level 2), Columns (Level 2)
  • Three levels: Rows, Columns, Rows (Level 2), Columns (Level 2), Rows (Level 3), Columns (Level 3)

Specify custom values, or leave them blank for auto-calculation. When auto-calculating, PuzzleMe determines the grid size based on your image dimensions. For example, a landscape image might auto-set the second level to 6 rows × 9 columns, while a portrait image might use 12 rows × 8 columns for the third level. Higher difficulty levels use progressively more pieces.

Important

You must provide both row and column values for a level, or leave both blank. If you provide only one (e.g., rows but not columns), the upload will fail.

Puzzle Configuration​

ColumnDescription
RowsRows for the first difficulty level (auto-calculated based on image dimensions if not specified)
ColumnsColumns for the first difficulty level (auto-calculated based on image dimensions if not specified)
Rows (Level 2)Rows for the second difficulty level (requires Rows and Columns headers; auto-calculated if blank)
Columns (Level 2)Columns for the second difficulty level (requires Rows and Columns headers; auto-calculated if blank)
Rows (Level 3)Rows for the third difficulty level (requires Rows, Columns, Rows (Level 2), and Columns (Level 2) headers; auto-calculated if blank)
Columns (Level 3)Columns for the third difficulty level (requires Rows, Columns, Rows (Level 2), and Columns (Level 2) headers; auto-calculated if blank)
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,Rows (Level 2),Columns (Level 2),Rows (Level 3),Columns (Level 3),Background color,Connect sound url,Start message,End message
https://exampleimage1.com,Sunset Beach,John Smith,4,6,6,9,8,12,#87CEEB,https://example.com/connect.mp3,Welcome to the puzzle!,Great job!
https://exampleimage2.com,Mountain View,Jane Doe,5,7,,,,,#FFE4B5,,Ready to solve?,
https://exampleimage3.com,Forest Path,,,,,,,,

In this example:

  • First row: Defines custom sizes for all three difficulty levels (4×6, 6×9, 8×12), plus background color and audio settings
  • Second row: Defines the first level (5×7) with a background color. Since the Level 2 and Level 3 headers are present in the CSV but values are blank, those levels will be auto-calculated
  • Third row: Includes only the required Image url. Since no other headers are present, only the first level will be created using auto-calculated values

Download example CSV file

Table of contents