Create Gift Box¶
Menu Location: Customers > Gift Boxes > Create Gift Box (kiv/gift-box-create.php)
(This section only appears if gift box sales are turned on for your store.)
Overview¶
Create Gift Box lets an admin set up a gift for someone directly, without the buyer going through the storefront or checkout. No charge is made. This is for comped gifts, replacements, or gifts arranged by phone or in person.
Submitting the form creates the gift record, a recipient customer account, a subscription for the recipient, and the recipient's first order.
Primary Functions:
- Set up a gift for a recipient with no checkout and no payment
- Choose the box, first delivery week, delivery count, and schedule
- Add an optional gift-wrapping add-on and gift message
- Jump straight to the new recipient's customer record after saving
Filling Out the Form¶
Recipient¶
- First name and Last name: required.
- Email (optional): the recipient's email address. Leave it blank if you do not have one; the system creates a placeholder login for the gift account instead. If the email already belongs to an account, the gift account is created with a modified address so the two do not collide.
Delivery Address¶
- Street, City, State, and Zip are all required and are used as the recipient's delivery address.
The Gift¶
- Box: choose from the same giftable boxes that appear on the customer gift page. Boxes are marked giftable on the Boxes page with "Show as Gift" or by being open for customer signup and not hidden from gift boxes.
- How often: shown only when more than one delivery schedule is available for the chosen box (weekly, every other week, monthly, and so on). A biweekly-only delivery area is set to every other week automatically.
- How many deliveries: shown when multi-week gifts are turned on in Gift Box Settings. The recipient gets exactly this many deliveries, then the gift ends.
- First delivery week: pick the week of the first delivery. Weeks your store is closed for a holiday are not offered.
- Packaging add-on: shown when the holiday packaging add-on is turned on. Checking it marks the gift as wrapped and adds a GIFT WRAP note to the recipient's order for the warehouse and driver. No charge is made either way.
If multi-week gifts are off, the page creates a single-delivery gift.
Gift Message (optional)¶
- To and From: the names shown on the gift message.
- Message: the gift message text. It is also passed to the recipient's order as shipping notes, so the driver sees it.
Click Create Gift Box to save.
After Saving¶
The gift is created and provisioned immediately. You are returned to a blank form with a confirmation message that links to:
- the new customer record for the recipient, and
- the full Gift Boxes list.
Because the gift is created and provisioned at the same time, there is no cart or payment step for it.
Common Use Cases¶
Use Case 1: Comp a Gift for a Friend or Partner¶
Goal: Send a box with no charge.
Steps:
- Open Create Gift Box.
- Enter the recipient's name and address.
- Choose the box and first delivery week.
- Add a gift message if you like.
- Click Create Gift Box.
Use Case 2: Replace a Missing or Damaged Gift Delivery¶
Goal: Send a replacement box to a gift recipient.
Steps:
- Open Create Gift Box and fill in the recipient's details.
- Choose the same box and the next available week.
- Save, then note the new gift record in the Gift Boxes list.
Use Case 3: Set Up a Multi-Week Gift In Person¶
Goal: Arrange a 4-delivery gift for someone who is not ordering online.
Steps:
- Make sure multi-week gifts are turned on in Gift Box Settings.
- On Create Gift Box, choose the box.
- Choose how often and how many deliveries (for example every other week, 4 deliveries).
- Choose the first delivery week and save.
Troubleshooting¶
The form will not save¶
First name, last name, street, city, state, zip, box, and delivery week are all required. The delivery week must not be older than the current week.
The box I want is not in the list¶
Only giftable boxes appear. On the Boxes page, turn on "Show as Gift" for that box, or make sure it allows customer signup and is not hidden from gift boxes.
I do not have the recipient's email¶
Leave the email blank. The system creates a placeholder login for the gift account. Note that gift conversion emails are only sent to recipients with a real email address.
The gift saved but the account did not¶
If the page reports that the gift record saved but provisioning failed, check the Gift Boxes list. The record exists but has no recipient account yet.
Related Pages¶
- Gift Boxes (
admin-edit.php?table=gift_boxes) - all gift purchase records - Gift Box Settings (
gift-box-settings.php) - multi-week options and the packaging add-on - Boxes (
admin-edit.php?table=boxes) - choose which boxes can be gifted
Recent Updates¶
2026-10-19: New Create Gift Box page. Admins can set up a comped gift directly, including multi-week delivery counts, a delivery schedule, and the packaging add-on, with no checkout or charge.