> ## Documentation Index
> Fetch the complete documentation index at: https://help.maestra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Delete Gift Cards

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.

<Warning>
  Deletion is permanent. Once gift cards are removed, they cannot be restored. Double-check your file before launching the import.
</Warning>

## 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

<Steps>
  <Step title="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**.
  </Step>

  <Step title="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**

    <Note>
      Make sure card numbers and pool system names contain no extra spaces. Stray whitespace will cause rows to fail.
    </Note>

    Upload the file to the import.
  </Step>

  <Step title="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).
  </Step>

  <Step title="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.

    <Warning>
      Once you launch the import, the deletion cannot be canceled. There is no undo.
    </Warning>

    Launch the import to remove the cards.
  </Step>
</Steps>

## 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.