Create gift card occasions
Gift card occasions are categories that group your gift card templates by theme, such as Birthday, Anniversary, or Holiday. Occasions appear on the Webstore as browsable categories so guests can find the right gift card for a specific event. You create occasions at the organization level and then associate them with gift card templates.
Note: Occasions are different from gift card types. Types (Amount, Service, Package) determine what a card can be redeemed for. Occasions (Birthday, Holiday) are organizational groupings for templates.
Before you begin
Permission: Add under GiftCardType in the Administrator section -- Required to create a new occasion.
Permission: Edit under GiftCardType in the Administrator section -- Required to modify an existing occasion.
- Plan the occasions you need before you begin. Common examples include Birthday, Anniversary, Holiday, Thank You, and General.
- Each occasion requires a unique code within your organization. Prepare codes in advance to maintain a consistent naming convention.
- If you plan to upload an image for each occasion, prepare the image file (.png,.jpg, or.jpeg) in advance. Images must be 800 × 400 px, maximum 10 MB.
On this page
- Create an occasion
- Occasion field reference
- Add occasion images
- Edit an existing occasion
- View and filter occasions
- Deactivate an occasion
- How occasions and templates work together
Steps
Create an occasion
At the organization level, navigate to Configuration > Gift cards > Gift card occasions.
Click Add. The Create gift card occasion page opens on the GENERAL step.
Enter the occasion details:
Field Description Code Enter a unique alphanumeric code for the occasion. The system enforces uniqueness across the organization. If you enter a code that already exists, the system displays an inline error and prompts you to use a different code. Name Enter a display name for the occasion. This name appears on the Webstore and in the admin interface. Description Enter a brief description of the occasion. Use this to clarify the intended use or theme. Frequency (in Days) Enter a number of days after which a reminder campaign is sent to the guest to purchase another gift card. This is a numeric days field (maximum three digits) that drives reminder-campaign timing — it is not a recurrence dropdown. Active Select this option to make the occasion available for use. Only active occasions appear when you assign an occasion to a gift card template. Click Next to move to the CATALOG step.
Optionally, upload an image for the occasion (see Add occasion images).
Click Finish to save the occasion.
Worked example: To create a Birthday occasion, enter Code
BDAY, NameBirthday, DescriptionFor celebrating birthdays, and Frequency (in Days)365. Leave Active selected and click Next, then Finish.
Occasion field reference
| Field | Required | Notes |
|---|---|---|
| Code | Yes | Must be unique across the organization. Use a short, descriptive code such as BDAY or HOLIDAY. |
| Name | Yes | Displayed to guests on the Webstore. Use a clear, recognizable name that guests associate with the event. |
| Description | No | Provides context for admin users and can appear in Webstore occasion listings. Keep it concise. |
| Frequency (in Days) | No | A numeric value (maximum three digits, in days) after which a reminder campaign is sent to the guest to purchase another gift card. It is not a recurrence dropdown. |
| Active | Yes | Controls whether the occasion is selectable on templates and visible on the Webstore. Defaults to active. |
Add occasion images
An image helps guests visually identify the occasion on the Webstore.
- Open the occasion you want to edit and go to the CATALOG step.
- In the Upload image area, click Upload and select the image file (.png,.jpg, or.jpeg) that represents the occasion theme. Images must be 800 × 400 px, maximum 10 MB.
- Enter the Alternate text for the image. Alt text is required — you cannot save the image without it.
- Click Finish to save the occasion.
Note: The system caches occasion images, so updates may take a few minutes to appear on the Webstore.
Note: By uploading an image file, you certify that you have the right to distribute the file and that it does not violate any copyrights.
Edit an existing occasion
- Navigate to Configuration > Gift cards > Gift card occasions.
- On the Gift card occasions list, click the occasion you want to modify.
- Update the fields as needed. You can change the name, description, frequency, active status, and image.
- Click Save.
View and filter occasions
- Navigate to Configuration > Gift cards > Gift card occasions.
- To find a specific occasion, enter its name in the Name box and click Search.
The list displays each occasion's Name, Frequency, and Active status.
Deactivate an occasion
When you deactivate an occasion, it no longer appears as an option when you create or edit gift card templates. Existing templates linked to the occasion are not affected, but you cannot assign the occasion to new templates.
- Navigate to Configuration > Gift cards > Gift card occasions.
- Open the occasion you want to deactivate.
- Clear the Active option.
- Click Save.
To reactivate the occasion later, select Active and save again.
Tips
- Keep occasion codes short and meaningful — codes like
BDAY,ANNIV, andHOLIDAYare straightforward to recognize when scanning long lists. - If the same theme applies to multiple sale periods (for example, a seasonal promotion), create separate occasions so you can associate different template images and descriptions without changing the shared occasion.
- Review the Frequency (in Days) value for each occasion periodically. Setting it too low can result in guests receiving reminder campaigns too frequently; setting it to
0disables reminder-campaign triggering for that occasion.
Troubleshooting
| Problem | Resolution |
|---|---|
| The system displays "Code is a required field" when saving. | Enter a value in the Code field. Occasion codes are mandatory. |
| The system displays an error stating the code already exists. | Choose a different value for Code. Occasion codes must be unique across the organization. |
| An occasion is not appearing in the gift card template editor. | Confirm that the Active option is selected for the occasion. Inactive occasions are hidden from the template picker. |
| An uploaded image is not showing on the Webstore after saving. | Changes may take a few minutes to appear. If the image still does not appear after several minutes, verify that the image meets the format requirements (.png,.jpg, or.jpeg, 800 × 400 px, maximum 10 MB) and that the Alternate text field was completed. |
How occasions and templates work together
Occasions provide the grouping structure that organizes templates for guest-facing display. When a guest browses gift cards on the Webstore, they first select an occasion and then choose from the templates assigned to that occasion.
| Scenario | Behavior |
|---|---|
| Active occasion with templates assigned | The occasion appears on the Webstore. Guests see all active templates linked to the occasion. |
| Active occasion with no templates assigned | The occasion does not appear on the Webstore because there are no templates for guests to select. |
| Inactive occasion with templates assigned | The occasion does not appear on the Webstore. The linked templates remain valid but are not accessible through this occasion's Webstore category. |
| Template linked to multiple occasions | The template appears under each active occasion it is assigned to. Guests can find the same template through different occasion categories. |