Bulk Upload Keywords
Use bulk upload to add or update many keywords at once using a spreadsheet file. You can upload .xlsx or CSV. Use .xlsx if you want pictures in the file or if your text is in Chinese or another language. A CSV file must be saved as CSV UTF-8.
Create new keywords
Section titled “Create new keywords”- Go to TOOLS › BULK UPLOAD KEYWORDS and click GET SAMPLE XLSX to download the template file.

- Open the file, fill in your product details, and save it as .xlsx. Leave the id column blank for new keywords. Boxify reads the first visible sheet.

- Drag the saved file into the upload area and click UPDATE OR CREATE.

After uploading, check the status column:
| Status | Meaning |
|---|---|
| NEW | Ready to add. Not saved until you click UPDATE OR CREATE. |
| EXISTING | Ready to update. Not saved until you click UPDATE OR CREATE. |
| OK | Saved. |
| DATA INVALID | Not uploaded. The Problem column shows what to fix. |
| FAILED | Not saved. The Problem column shows the reason. |
| RULE FAILED | The keyword saved, but its discount rule was not linked. Set the rule on the keyword’s page. Do not upload it again. |

Add pictures to new keywords
Section titled “Add pictures to new keywords”There are two ways to add pictures. Both work for new keywords only, with up to 5 pictures per keyword, or 10 on the Enterprise plan.
- Put the picture in the sheet (.xlsx only). Insert it in the keyword’s row, as in the sample file. Use PNG, JPG, GIF or WEBP. Several pictures on one row are added from left to right. A floating picture counts for the row where its top-left corner sits. A picture placed inside a cell needs its own empty cell.
- Paste image links (.xlsx or CSV). Put links that start with
https://in the images column, separated by commas.
The Images column of the table shows a preview before you upload. Check that each picture is on the right row.
Boxify tells you how many pictures will not be used. This covers pictures on update rows, on rows with no keyword, and in other file types.
Fix rows with problems
Section titled “Fix rows with problems”One bad row doesn’t stop the others. UPDATE OR CREATE uploads the valid rows and skips the rest.
- Tick Show only rows with problems to see what needs fixing. Row numbers match your spreadsheet.
- Click DOWNLOAD FAILED LIST. The file has your rows plus an error column that explains each one.
- Fix the rows, then upload that file. Do not upload the original file again.
The failed list does not keep pictures that were in your sheet, only image links. If a failed row had pictures, fix it in your own spreadsheet, delete the rows that saved, and upload that file.
If a row shows a problem with extra_cells, the row had more cells than the header row, usually from a comma inside a cell. Fix the row and clear the extra_cells cell.
If a column isn’t recognised, Boxify lists it above the table and ignores it. Check the spelling against the sample file.
Update existing keywords
Section titled “Update existing keywords”- Go to KEYWORDS, filter to find the keywords you want to edit, then click Export in the top right.

- Open the exported file and make your changes. Keep the id column as-is — Boxify uses it to match each row to the correct keyword.

- Go to TOOLS › BULK UPLOAD KEYWORDS, drag the updated file in, and click the update button.

Rules for updates
Section titled “Rules for updates”- Blank cells are not updated. On a row with an id, Boxify keeps the saved value for any blank cell. To clear a value, such as a SKU, use the keyword’s own page.
- Photos are not updated. Pictures and the images column only apply to new keywords.
Stock and stockLeft go together
Section titled “Stock and stockLeft go together”Fill in stock and stockLeft together, or leave both blank. A row with only one of them is not uploaded. This applies to new keywords too.
Bulk upload photos and video links
Section titled “Bulk upload photos and video links”To attach the same photo or video link to several keywords at once instead of editing each one separately:

- Go to KEYWORDS and select the keywords you want to update.
- Click IMAGES.
- Upload the photo.
- Paste in the video link.
- Click Save.
See also: