Skip to main content
Sometimes you need to clear out gift cards from a project — test cards from a pilot, cards from a discontinued program, or batches created by mistake. Maestra lets you delete gift cards in bulk through a file import.
Deletion is permanent. Once gift cards are removed, they cannot be restored. Double-check your file before launching the import.

​
Before you start

You can only delete gift cards that have no associated transactions. Maestra blocks the removal of cards that are linked to sales or payment orders. Before importing your delete file, make sure that:
  • The cards you want to delete have no sales, purchases, or payments tied to them.
  • If any of the cards do have related orders, either remove those orders first or exclude the cards from your file.
To check which actions are tied to a specific card or pool, go to Data → Actions. Use the filters to find all sales, purchases, or operations involving the gift cards or pools you’re about to delete.

​
Delete gift cards in bulk

1

Choose the action type

In Maestra, open the import section and create a new import. For the import type, select Loyalty → Gift Cards. For the action, select Delete Gift Cards.
2

Prepare and upload your file

Prepare a CSV or TXT file with the gift cards you want to delete. The file must include two fields for each card:
  • Card number
  • Pool system name
Make sure card numbers and pool system names contain no extra spaces. Stray whitespace will cause rows to fail.
Upload the file to the import.
3

Map the file fields

Match the columns in your file to the corresponding Maestra fields. Use the checkboxes to mark which fields should be included in the import, then map each file column to the right Maestra field (card number and pool system name).
4

Verify and launch the import

Review the data one more time before you start the import. Confirm that the card numbers, pool system names, and field mappings are all correct.
Once you launch the import, the deletion cannot be canceled. There is no undo.
Launch the import to remove the cards.

​
Track the import

After you launch the import, Maestra shows the task status along with the launch date and the user who started it. When the import finishes, the deleted cards are permanently removed and no longer appear in your project’s gift card lists.

​
If deletion fails

If some cards can’t be deleted, it’s almost always because those cards still have associated actions (sales, purchases, or payments). To resolve this:
  1. Go to Data → Actions and filter by the card number or pool to find the related operations.
  2. Remove those actions, or exclude the affected cards from your delete file.
  3. Re-run the import with the corrected file.