Skip to content

Bulk Upload Keywords

Open in ChatGPT

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.

  1. Go to TOOLS › BULK UPLOAD KEYWORDS and click GET SAMPLE XLSX to download the template file. Animation showing how to download the bulk upload keywords sample file
  2. 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. Animation showing how to fill in keywords in the spreadsheet
  3. Drag the saved file into the upload area and click UPDATE OR CREATE. Animation showing the bulk upload process

After uploading, check the status column:

StatusMeaning
NEWReady to add. Not saved until you click UPDATE OR CREATE.
EXISTINGReady to update. Not saved until you click UPDATE OR CREATE.
OKSaved.
DATA INVALIDNot uploaded. The Problem column shows what to fix.
FAILEDNot saved. The Problem column shows the reason.
RULE FAILEDThe keyword saved, but its discount rule was not linked. Set the rule on the keyword’s page. Do not upload it again.

Screenshot showing NEW status after upload Screenshot showing OK status after upload

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.

One bad row doesn’t stop the others. UPDATE OR CREATE uploads the valid rows and skips the rest.

  1. Tick Show only rows with problems to see what needs fixing. Row numbers match your spreadsheet.
  2. Click DOWNLOAD FAILED LIST. The file has your rows plus an error column that explains each one.
  3. 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.

  1. Go to KEYWORDS, filter to find the keywords you want to edit, then click Export in the top right. Animation showing how to export keywords
  2. 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. Animation showing how to update keywords in the spreadsheet
  3. Go to TOOLS › BULK UPLOAD KEYWORDS, drag the updated file in, and click the update button. Animation showing how to upload the updated keywords file
  • 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.

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.

To attach the same photo or video link to several keywords at once instead of editing each one separately:

Animation showing how to bulk upload photos and video links to keywords

  1. Go to KEYWORDS and select the keywords you want to update.
  2. Click IMAGES.
  3. Upload the photo.
  4. Paste in the video link.
  5. Click Save.

See also:

© 2026 Boxify. All rights reserved.