---
title: "Gift Wrapping"
description: "The Gift Wrapping app adds an optional step to your J2Commerce checkout where customers can select gift wrapping for their order."
url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps/app-giftwrapping"
markdown_url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps/app-giftwrapping.md"
last_updated: "2026-10-31T23:33:49+00:00"
version: "J2Commerce 6"
breadcrumbs:
  - title: "Home"
    url: "https://docs.j2commerce.com/"
  - title: "J2Commerce 6"
    url: "https://docs.j2commerce.com/v6"
  - title: "Apps and Extensions"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions"
  - title: "Apps"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps"
  - title: "Gift Wrapping"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions/apps/app-giftwrapping"
---

# Gift Wrapping

The Gift Wrapping app adds an optional step to your J2Commerce checkout where customers can select gift wrapping for their order. You can offer multiple wrapping options with different prices, images, and descriptions. Customers can also include a personal message to be included with the gift.

This feature is perfect for stores selling gifts, seasonal merchandise, or any products where customers may want a special presentation.

## Requirements

- with PHP 8.3.0 +
- Joomla! 6.x
- J2Commerce 6.x

## Purchase and Download

The **Gift Wrapping** app is a premium add-on available from the J2Commerce extension directory.

**Step 1:** Go to our [**J2Commerce** website](https://www.j2commerce.com/extensions) **->** **Apps**

**Step 2:** Locate the **Gift Wrapping** App **->** click **View Details -> Add to cart -> Checkout**.

**Step 3:** Go to your **My Downloads** under your profile button at the top right corner and search for the app. Click **Available Versions -> View Files -> Download**

## Install the App

In the Joomla Administrator, go to **System** **->** **Install** **->** **Extensions**.

Upload the plugin ZIP file or use the Install from URL option.

![Joomla System Dashboard with System in the sidebar and the Install Extensions link highlighted to open the extension installer](https://docs.j2commerce.com/images/docs/shared/install.webp)

## Enable the App

Once you have installed the App, you will need to enable it. There are **two** ways you can access the App.

**Option A:** Go to the **J2Commerce** icon at the top right corner **-> Apps**

**Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Apps**

![Joomla admin navigation to J2Commerce Apps: Components, J2Commerce, Apps in the sidebar and Apps in the J2Commerce menu highlighted, above the list of apps](https://docs.j2commerce.com/images/docs/shared/gift-wrap-apps.webp)

To help you narrow down the list, you can do a search for **Gift Wrapping**, click the **X,** and it will turn into a green checkmark. It is now enabled and ready for setup.

![J2Commerce Apps list searched for "gift", with the search box and the Gift Wrapping enabled status icon highlighted](https://docs.j2commerce.com/images/docs/shared/gift-wrap-enable1.webp)

## Configure the App

Click on the **Gift Wrapping** Title to open it.

> **Tip:** Click the **Toggle Inline Help** button in the toolbar and the app will show a description below each field as you configure it.

### Plugin Tab

![Gift Wrapping plugin with the Step Position dropdown highlighted and set to After Shipping Address, plus Toggle Inline Help in the toolbar](https://docs.j2commerce.com/images/docs/shared/setutup7.webp)

**Enable Gift Wrapping:** Show or hide the gift wrapping step in checkout.

**Step Position:** Where in the checkout flow the gift wrapping step appears.

> **Info:** NOTE: The gift wrapping step can appear at different points in the checkout flow.

**After Billing Address:** Shows after the billing address step (default)

**After Shipping Address:** Shows after the shipping address step

**Before Payment Method:** Shows before the payment selection step

**Before Confirm Order:** Shows just before the order confirmation step

Choose the position that best fits your checkout flow. For most stores, After Billing Address or After Shipping Address works well.

**Show Message Field:** Allow customers to include a personal message with the gift wrapping.

### Add Gift Wrapping Options Tab

![Gift Wrapping plugin, Gift Wrapping Options tab highlighted: an empty first row with Name (required), Price 0, Image Select button and Description, plus add and remove buttons](https://docs.j2commerce.com/images/docs/shared/gift-wrap-setup2.webp)

In the **Gift Wrapping Options** tab, define each wrapping option available to customers.

1. Click the **green plus icon to** create a new wrapping option.
2. Fill in the following fields:

**Name:** The name displayed to customers (e.g., "Standard Gift Wrap", "Premium Gift Box").

**Price:** The cost for this wrapping option. Enter `0` for free gift wrapping.

**Image:** An optional image showing the wrapping style. Upload to `media/com_j2commerce/giftwrapping/`.

**Description:** A short description of the wrapping (e.g., "Red ribbon with white gift tag").

1. Click **Add** again to add more options.
2. Use the drag blue icon on the right up/down, to rearrange the options.
3. Click **Save** or **Save & Close**.

   ![Gift Wrapping plugin, Gift Wrapping Options tab: rows for Gift Bag at 2 and Gift Box at 5, each with an image path, Select button and description](https://docs.j2commerce.com/images/docs/shared/gift-options.webp)

### Creating Effective Wrapping Options

Consider these strategies:

- **Free option** — Offer a basic gift wrap at no charge to encourage selection.
- **Premium tier** — Charge more for elaborate packaging or branded gift boxes.
- **Seasonal options** — Add holiday-themed wrapping during gift-giving seasons.
- **Clear images** — Upload photos of actual wrapping to set customer expectations.

## How It Works

When a customer reaches the gift wrapping step during checkout:

1. They see a list of wrapping options with images, descriptions, and prices.
2. The first option is always **No Gift Wrapping** (free, no packaging).
3. Selecting a paid option adds the gift wrapping fee to the order total.
4. If the **Show Message Field** is enabled, a text area appears for a personal message (max 500 characters).

## Frontend View

![Checkout Gift Wrapping step with No Gift Wrapping, Plain Wrapping $2.00 selected, Premium Wrapping $5.00 and a Personal Message box highlighted, with a Gift Wrapping line in the totals](https://docs.j2commerce.com/images/docs/shared/gift-checkout.webp)

### Fee Integration

When a customer selects a paid wrapping option:

- The fee appears in the order summary as "Gift Wrapping (Option Name)".
- The fee is added to the order total before tax calculation.
- The selected option and message are stored with the order.

## Display Conditions

The gift wrapping step only appears when:

- **Enable Gift Wrapping** is set to '**Yes**' in the app.
- At least one gift wrapping option is configured.
- The cart contains at least one shippable item.

If the cart contains only digital products (no shipping required), the gift wrapping step is automatically hidden.

![Gift Wrapping settings, Plugin tab: Enable Gift Wrapping switch highlighted as Yes, Step Position After Billing Address, Show Message Field Yes](https://docs.j2commerce.com/images/docs/shared/setutup3.webp)

## Tips

- Upload clear images of each wrapping style to help customers make informed choices.
- Keep descriptions short but descriptive — customers scan quickly during checkout.
- Test the checkout flow after configuring to ensure the step appears in the correct position.
- Consider offering a free option to make gift wrapping accessible to all customers.

## Troubleshooting

### Gift Wrapping Step Does Not Appear

**Cause:** The step is hidden due to configuration or cart contents.

**Solution:**

1. Verify **Enable Gift Wrapping** is set to **Yes**.
2. Check that at least one gift wrapping option is configured in the **Gift Wrapping Options** section.
3. Ensure the cart contains at least one physical product that requires shipping.
4. Verify the plugin is enabled in **J2Commerce** **->** **Apps** **-> Gift Wrapping**

![J2Commerce Apps list searched for "gift", with the search box and the Gift Wrapping enabled status icon highlighted](https://docs.j2commerce.com/images/docs/shared/gift-wrap-enable2.webp)

### Fee Not Added to Order

**Cause:** JavaScript error or session issue.

**Solution:**

1. Open the browser Developer/Inspect Tools (F12) and check the Console for errors.
2. Clear browser cache and cookies, then try again.
3. Verify the wrapping option has a price greater than `0`.

### Message Field Not Showing

**Cause:** The **Show Message Field** setting is disabled.

**Solution:**

1. Go to **J2Commerce** -> **Apps** -> **Gift Wrapping**.
2. Set **Show Message Field** to **Yes**.
3. Click **Save**.

![Gift Wrapping settings, Plugin tab: Show Message Field switch highlighted as Yes, below Step Position set to After Billing Address](https://docs.j2commerce.com/images/docs/shared/setutup4.webp)

### Gift Wrapping Step Appears in Wrong Position

**Cause:** Step position is configured incorrectly.

**Solution:**

1. Go to **J2Commerce** **-> Apps ->** **Gift Wrapping**.
2. Change **Step Position** to the desired location in the checkout flow.
3. Click **Save**.
4. Test the checkout to verify the position.

![Gift Wrapping settings, Plugin tab: Step Position dropdown highlighted and set to After Billing Address, with Enable Gift Wrapping Yes](https://docs.j2commerce.com/images/docs/shared/setutup5.webp)

### The gift wrapping option doesn't appear in the checkout process

**Cause:** The product being purchased doesn't have 'Shipping' enabled

**Solution:**

At least **one** physical product in the shopping cart requires shipping

1. Go to **J2Commerce -> Catalog -> Product ->** Open the product
2. Go to **J2Commerce** tab **-> Shipping** tab
3. Set **Enable Shipping** to **'Yes'**

![Product edit, Shipping tab highlighted with the Enable Shipping switch highlighted and set to Yes, above Length, Width and Height dimensions at 0](https://docs.j2commerce.com/images/docs/shared/gift-shipping.webp)

### Options Display, but Images Don't Load

**Cause:** Image path is incorrect, or the file doesn't exist.

**Solution:**

1. Go to **Content** -> **Media**.
2. Navigate to `com_j2commerce/gift-wrapping/` folder. (or whatever you named the folder)

   ![Joomla Media manager under Content, Media with the images folder open and the gift-wrapping folder highlighted beside banners, headers and sampledata](https://docs.j2commerce.com/images/docs/shared/gift-wrap-media.webp)
3. Open the folder to verify the images exist in this location.
4. Open the Gift Wrapping Options tab in the app and re-select the images in the plugin configuration.

![Gift Wrapping settings, Gift Wrapping Options tab highlighted: Plain Wrapping priced 2 and Premium Wrapping priced 5, with image path fields highlighted](https://docs.j2commerce.com/images/docs/shared/setutup6.webp)