ups-banner-bg
ph_img_faq_page_image

FedEx Hazardous Materials / Dangerous Goods Shipping – WooCommerce Shipping Plugin for FedEx FAQs

    Configure FedEx shipping for hazardous or restricted materials in WooCommerce

Questions in this section:

How can I verify and troubleshoot discrepancies in FedEx hazardous goods shipping rates and options returned by the WooCommerce FedEx Shipping Plugin?

  1. Ensure the product’s "Dangerous Goods Option Type" is correctly set to "Hazardous Materials" and all DG-required fields (Hazard Class, Proper Shipping Name, UN number) are accurate.
  2. Confirm with your FedEx account manager or your FedEx online account whether your account permits hazardous shipments and which services are allowed.
  3. Test shipping rates directly on fedex.com by logging in and entering identical shipment details (origin, destination, package weight, product type) under hazardous shipment criteria.
  4. Compare these FedEx website rates specifically for FedEx Ground service with the rates shown in the plugin at checkout. Differences might arise if residential delivery surcharges or account-specific fees apply.
  5. If there are rate discrepancies or missing shipping options in the plugin, enable the plugin’s Debug Mode and generate a Diagnostic Report to review rate requests and responses for hazardous shipments; this report can be submitted to PluginHive support for investigation.
  6. Note that air shipping options for hazardous goods will not appear in the plugin, reflecting FedEx’s service restrictions rather than plugin malfunction.

Can the WooCommerce FedEx Shipping Plugin return FedEx Home Delivery or FedEx Air services for hazardous products?

  1. FedEx policy restricts hazardous materials shipments primarily to FedEx Ground service.
  2. If a hazardous product is in the cart, selecting Home Delivery or Air services leads to no shipping methods being returned by the plugin.
  3. The plugin will only provide shipping options using FedEx Ground for products marked as Dangerous Goods.
  4. Users must ensure checkout shipping options align with FedEx Ground service for hazardous shipments to receive valid rates and avoid errors.

Can the WooCommerce FedEx Shipping Plugin be customized to selectively disable HazMat surcharges based on packaging criteria or small battery exceptions under FedEx policies?

  1. Plugin rate calculations and service availability strictly mirror the FedEx API responses and FedEx’s hazardous materials shipping policy, which applies surcharges at the service level, not by package exceptions.
  2. FedEx’s APIs do not provide granular exceptions or conditional surcharges based on packaging details or limited quantity exceptions; instead, shipments marked as HazMat receive surcharges when shipped via eligible services (typically FedEx Ground).
  3. To benefit from small battery exceptions that waive HazMat surcharges on certain services like Home Delivery, the product must not be classified as hazardous in the plugin, but this bypasses official hazardous shipping fees and may not comply with FedEx requirements.
  4. Any deviation from this is outside the plugin’s automated configuration and would require manual shipment arrangements, possibly managed outside of the WooCommerce FedEx Shipping Plugin integration.
  5. For accurate compliance and rate application, products should be fully and correctly marked according to their hazardous characteristics, and shipping service options accepted by FedEx for those products should be used.

Can the WooCommerce FedEx Shipping Plugin be configured to ship hazardous battery products by air, including international shipments such as to France?

  1. Hazardous goods marked in the plugin will only return FedEx Ground shipping options, not air or international air services.
  2. If you enter a shipping address in France or select air services, no shipping options will appear for hazardous products because FedEx does not allow international air shipment of hazards through these services.
  3. To ship internationally or by air, you must manage compliance and shipping arrangements outside of the plugin’s automation or manually adjust product classifications where applicable.
  4. Ensure hazardous products are properly marked under "Dangerous Goods Option Type" → "Hazardous Materials" to receive valid FedEx Ground rates, but air options will not be available for these products in the plugin.

Why does the WooCommerce FedEx Shipping Plugin treat lithium-ion batteries shipped under the Limited Quantity exemption differently from general Dangerous Goods?

  1. FedEx’s Dangerous Goods (DG) Hotline clarified that Limited Quantity exemptions do not apply to batteries under their regulatory interpretation.
  2. Batteries (UN3480, UN3481) shipped by air are considered full Dangerous Goods; thus, the “Battery” option in the plugin is valid only for ground shipments within the U.S.
  3. The plugin reflects this by treating Battery and Dangerous Goods as mutually exclusive classifications, following FedEx’s service and regulatory restrictions.
  4. Although FedEx Ground may practically accept Limited Quantity lithium-ion batteries, the API responses and plugin processing do not currently support combining Battery exceptions with full DG for express services simultaneously.

Why does the WooCommerce FedEx Shipping Plugin return only FedEx Express services and exclude FedEx Home Delivery for products marked as limited quantity hazardous materials?

  1. FedEx limits "Limited Quantities Commodities" shipments strictly to FedEx Express services; FedEx Ground or Home Delivery services are ineligible for such shipments.
  2. The FedEx API used by the plugin complies with these restrictions and accordingly returns only Express shipping service options for limited quantity DG products.
  3. FedEx.com public rates may differ or list Home Delivery for similar shipments, but these are not authoritative and may not reflect actual eligible services.
  4. FedEx recommends using FedEx Ship Manager or direct FedEx account tools to verify permissible services and shipping options for dangerous goods shipments reliably.
  5. Therefore, the plugin's exclusion of Home Delivery for limited quantity DG products is consistent with FedEx’s official hazardous goods shipping policies and is intended to maintain compliance.

Why does FedEx Express recommend not using ORM-D or Limited Quantity classifications for batteries and what should be used instead?

  1. ORM-D is no longer a valid regulatory designation for hazardous materials shipments, including batteries.
  2. Limited Quantity or Small Quantity exceptions do not apply to batteries shipped by FedEx.
  3. For ground shipments of excepted batteries, the correct option is the **Battery** designation, which covers batteries excepted under federal hazardous materials regulations (49 CFR).
  4. For air shipments, lithium batteries are classified under full Dangerous Goods regulations and must be handled with corresponding Dangerous Goods declarations, e.g., UN3480 classification with proper DG paperwork.
  5. This classification information is based on federal regulations and FedEx’s Dangerous Goods Hotline guidance. Shippers need proper training and must be aware that they are responsible for correct classification and regulation compliance.
  6. Using incorrect classifications like ORM-D or Limited Quantity may result in rejected shipments or inaccurate rate quotes.

Why are Dangerous Goods surcharges not reflected in the shipping cost at checkout despite filling the fields in the product settings?

  1. The Dangerous Goods option type may not be correctly set; for instance, battery products require the "Dangerous Goods Option Type" to be specifically set as "Hazardous Materials," and the "Battery Product" flag should be turned off to correctly apply surcharges.
  2. The service type used for checkout may not support hazardous materials. FedEx Ground is the only supported service for hazardous shipments. If “Home Delivery” is selected for such products, no rates will be returned. Instead, you must use FedEx Ground service for hazardous goods to get valid rates including surcharges.
  3. Plugin or FedEx account settings could influence rate quotes; ensure your FedEx account is enabled for international DG shipments, if applicable.
  4. The plugin may require debugging information to verify that hazmat details are correctly sent and acknowledged in FedEx’s rate responses.

Why am I getting the error “Package 1 – Packaging is required for hazardous commodity content” when generating FedEx labels with Dangerous Goods Option Type set to “Hazardous Materials”?

  1. Go to the PluginHive FedEx plugin’s packaging settings tab.
  2. Ensure you have enabled the “Hazardous (HazMat) Packaging” option.
  3. Verify that your products are correctly associated with the appropriate packaging types required for hazardous materials.
  4. Confirm that the package details (Height, Width, Length) are accurately entered.

Who should customers contact for more detailed or authoritative guidance about FedEx shipping restrictions for limited quantity hazardous goods when using the WooCommerce FedEx Shipping Plugin?

  1. Clarifications on service eligibility and restrictions for limited quantity hazardous goods shipments.
  2. Detailed information on packaging, labeling, and shipping compliance requirements affecting service availability and surcharges.
  3. Assistance using official FedEx tools such as FedEx Ship Manager to verify shipping options beyond FedEx.com or API responses.
  4. FedEx DG Hotline contact: 877-339-2774 (as cited in PluginHive support communications).
  5. PluginHive recommends consulting FedEx directly where service eligibility is unclear or when discrepancies arise between FedEx’s public documentation and API responses.

When I mark a product as Dangerous Goods and Hazardous Materials and fill in all additional fields at the variation level, why doesn't the plugin send the Dangerous Goods information to FedEx in the rate request unless the product is marked as "Pre packed"? Is it required to mark a product as "Pre packed" for the HazMat information to be included in the rate request?

The plugin requires proper configuration of custom boxes to correctly include Dangerous Goods and Hazardous Materials information in the FedEx rate request. For the plugin to send HazMat fees and Dangerous Goods data successfully:

  1. You must define custom box dimensions and settings tailored to your products.
  2. Dangerous Goods products need to be assigned to these custom boxes so the plugin understands how to pack the item.
  3. Only when the product is appropriately associated with a valid custom box configuration will the plugin send the HazMat information in the rate request.

Marking products as "Pre packed" is an alternative method where the plugin sends the Dangerous Goods info directly because it assumes packaging is already finalized. However, if you prefer to use custom boxes, ensure your box dimensions and configurations are accurately set up; otherwise, the HazMat info may not be included in the shipment request.

In summary, it is not required to mark a product as "Pre packed," but you must correctly set up and assign custom boxes for Dangerous Goods items to have the HazMat details sent with the FedEx rate request.

What troubleshooting steps can a user follow if Dangerous Goods surcharges are not appearing correctly for hazardous products in the WooCommerce FedEx Shipping Plugin?

  1. Confirm that all required Dangerous Goods information is accurately completed in each hazardous product’s FedEx Shipping Details section, including Hazard Class, Proper Shipping Name, and UN number.
  2. Verify the product’s “Dangerous Goods Option Type” is set correctly (e.g., “Hazardous Materials” or “Limited Quantities Commodities”).
  3. Ensure that shipping services selected at checkout are supported for hazardous shipments—typically FedEx Ground service, not Home Delivery or Air services.
  4. Enable the plugin’s Debug Mode (General Settings tab) to capture detailed API request and response data related to hazardous shipments.
  5. Reproduce the issue by testing rates with hazardous products in the cart and proceed to checkout.
  6. Generate a Diagnostic Report via the plugin’s Help & Support page and review it for indications that DG fields are transmitted and surcharges applied.
  7. Submit the Diagnostic Report to PluginHive support for assistance in identifying misconfiguration or API-related issues.
  8. Contact FedEx directly if needed to confirm that your FedEx account and services support hazardous shipments and surcharges.

What practical steps should users take to verify and troubleshoot FedEx shipping rates and service availability for Limited Quantity hazardous goods shipments using the WooCommerce FedEx Shipping Plugin?

  1. In the WooCommerce product FedEx Shipping Details, set the “Dangerous Goods Option Type” accurately, e.g., “Limited Quantities Commodities,” and complete all required DG fields like Hazard Class and UN number.
  2. Attempt to obtain shipping rates at checkout to observe which FedEx services are returned by the plugin (expect FedEx Express services for limited quantity DG).
  3. Log in to your FedEx business online account or FedEx Ship Manager application and input the identical shipping parameters to compare official FedEx service availability and rates in real time.
  4. Review FedEx’s official hazardous materials shipping guidelines or contact FedEx Dangerous Goods Support directly to confirm permitted shipping methods, pricing, and restrictions for your shipments.
  5. If discrepancies arise between plugin-reported rates and expected FedEx policies (such as FedEx Ground eligibility), enable Debug Mode in the plugin settings, reproduce the shipment scenario, generate a Diagnostic Report via the Help & Support tab, and submit it to PluginHive support for detailed API request/response analysis.
  6. Include your FedEx point of contact or account representative in communications with PluginHive to facilitate direct clarification with FedEx if needed.

What do I do if no shipping options appear for a hazardous product when the Dangerous Goods checkbox is enabled?

  1. FedEx does not provide the Home Delivery service option for hazardous material shipments; only FedEx Ground is available. Ensure the shipping method selected in checkout aligns with FedEx Ground for hazardous products.
  2. If Home Delivery or unsupported services are requested with Dangerous Goods enabled, the plugin will not return any available shipping options. In this case, verify the shipping address and service type compatibility for DG products.
  3. Confirm that the product’s DG settings are correctly configured, including "Dangerous Goods Option Type" and that the product is marked as hazardous properly in the plugin’s product settings.

What are the implications of the Dangerous Goods Option Type setting on FedEx shipping rates and label generation in the PluginHive FedEx plugin?

  • "Limited Quantity Commodities" is not supported for FedEx Ground or FedEx Home Delivery services, so setting this option will prevent rates for these services from being returned.
  • "Small Quantity Exception" allows getting FedEx rates but may restrict shipping services to those allowed for such materials, including sometimes forcing Home Delivery for residential addresses.
  • "Hazardous Materials" requires you to enable “Hazardous (HazMat) Packaging” and provide detailed package information; failing to do so will cause label creation errors such as “Packaging is required for hazardous commodity content.”

What are the federal training and compliance requirements for handling and shipping hazardous materials including batteries with FedEx?

  1. All personnel involved in packaging, shipping, and transporting hazardous materials must complete required training as per 49 C.F.R. §§172.700–172.704. This training covers classification, packaging, marking, labeling, and shipping protocols.
  2. Shippers bear full responsibility for accurate classification of commodities and proper documentation. FedEx does not verify the accuracy of Safety Data Sheets (SDS) or classifications provided.
  3. Compliance with all applicable governmental regulations (DOT, IATA, ICAO, etc.) is mandatory for shipment acceptance and liability coverage.
  4. FedEx’s guidance and materials are provided as courtesy only and do not replace regulatory training or legal requirements.
  5. Dangerous Goods training ensures compliance with packaging, documentation, handling, and emergency response necessary for safe transport.
  6. Failure to comply may result in shipment refusal, fines, legal penalties, or liability for incidents during transportation.
  7. Regular review of changing regulations and FedEx policies is essential to maintain compliance.
  8. Always consult official regulatory authorities, FedEx Dangerous Goods Hotline, and obtain proper training before preparing hazardous materials shipments.

Is there a way to configure the WooCommerce FedEx Shipping Plugin to classify a product as a limited quantity exemption rather than fully regulated hazardous material to allow FedEx Home Delivery and exclude Dangerous Goods surcharges?

  1. Setting this classification still results in only FedEx Express services being returned by the FedEx API, as FedEx restricts hazardous materials shipments under limited quantity exceptions to Express services only.
  2. FedEx Home Delivery and FedEx Ground services are not returned or available through the API for limited quantity DG shipments, regardless of product classification in the plugin.
  3. Due to this FedEx policy, the plugin cannot be configured to exclude HazMat surcharges by allowing Home Delivery for limited quantity battery products or reclassify them to bypass these restrictions without violating shipping regulations.
  4. Customers needing service options beyond FedEx Express for limited quantity shipments must manage shipments externally or through FedEx Ship Manager software, as the plugin reflects only what FedEx API permits.

If a merchant requires the ability to configure a product with both Battery and Dangerous Goods options for different FedEx services, what options are available?

  1. The plugin does not support mixed Battery and Dangerous Goods configurations per product within its default functionality.
  2. Merchants needing this capability can consider purchasing a paid customization from PluginHive, with costs starting around $500.
  3. The customization effort depends on the complexity, including development, testing, and ongoing compatibility with WooCommerce and WordPress updates.
  4. The merchant can discuss business requirements directly with PluginHive support or sales representatives to explore customization options and obtain a quote.
  5. Alternatively, merchants may manage such shipping scenarios manually outside the plugin or via separate product SKUs configured for either Battery or Dangerous Goods shipments.

How can I resolve the issue where Dangerous Goods information is not sent in the FedEx rate request despite having custom boxes configured?

To resolve this issue, follow these steps:

  1. Double-check your custom box configurations:
  2. Ensure Dangerous Goods products are assigned to the correct custom box:
  3. Review the Dangerous Goods and Hazardous Materials fields at the variation level:
  4. After updating the box sizes or assignments, test the cart and checkout process again:

If this setup is incorrect or incomplete, the plugin will not send HazMat details unless the product is marked as "Pre packed." Correcting the custom box setup typically resolves this issue.

How can I manage shipping rates and hazardous materials surcharges for battery shipments to international destinations like France, given that PlugInHive’s current behavior does not add surcharges correctly for air shipments?

  1. Understand that air (Express) shipments of lithium batteries require full DG handling and surcharges, which are not applied if the Battery option (ground only) is used.
  2. Separate shipment logic is required to differentiate between the ground and air shipments in PluginHive:
  3. Without this separation, the API will return rates without hazardous materials surcharges for air shipments, requiring manual rate adjustment post-order.
  4. Until PluginHive adds logic to support separate DG options for different modes of transport within the same product, partial workarounds include:
  5. Confirm your product classification and shipping destination within regulations to avoid shipment refusals or noncompliance.

How can a support call be arranged for urgent plugin issues when direct access is restricted?

  1. Share a meeting link (e.g., Microsoft Teams or Zoom) with all relevant parties.
  2. Confirm the call timing based on the availability of the dev team and PluginHive support.
  3. Use the call to collaboratively diagnose and resolve plugin issues.
  4. After resolution, confirm if further support calls are needed to ensure the problem is fully addressed.

How can a merchant verify that the WooCommerce FedEx Shipping Plugin’s handling of Battery and Dangerous Goods classifications aligns with FedEx shipping regulations and API policies?

  1. Confirm product Dangerous Goods settings in the plugin, ensuring accurate classification between Battery and Hazardous Materials.
  2. Consult your FedEx Dangerous Goods representative or FedEx account manager to understand service-level restrictions and classifications for your shipments.
  3. Use FedEx Ship Manager or business FedEx online tools to test shipment configurations identical to your plugin setup, verifying which services and surcharges FedEx supports for Battery and DG shipments.
  4. Ensure the shipping methods returned by the plugin correspond with FedEx’s API responses and official policy guidelines.
  5. For complex or borderline cases, contact FedEx Dangerous Goods support to clarify service eligibility and compliance.
  6. Report any discrepancies or unusual behaviors to PluginHive support with relevant diagnostic logs for investigation.

Does the WooCommerce FedEx Shipping Plugin support shipping lithium-ion batteries that qualify under the limited quantity exception (UN3480) via FedEx Home Delivery without HazMat surcharges?

  1. Products classified as "Limited Quantities Commodities" (including certain lithium-ion batteries under limited quantity exceptions) are eligible for shipment **only via FedEx Express services**.
  2. FedEx Ground services, including FedEx Home Delivery, are **not available** for limited quantity hazardous shipments and thus are not returned by the FedEx API or the plugin for these products.
  3. Although FedEx’s public website (FedEx.com) may display Home Delivery as an option for these shipments, this is not reliable or supported for rate quoting and shipping via the API or official shipping management tools. Instead, FedEx Ship Manager software should be used for precise DG shipment service verification.
  4. Consequently, the plugin correctly reflects FedEx’s limitations and only returns Express shipping options for limited quantity hazardous products, excluding Home Delivery to comply with regulation and FedEx’s service constraints.
  5. There is currently no plugin configuration to enable Home Delivery or classify limited quantity HazMat shipments differently to bypass these FedEx service restrictions.

Does the PluginHive plugin support the delivery of hazardous materials such as hydrogen therapy products listed on my website?

Yes, the PluginHive plugin supports shipping hazardous materials (Hazmat products). You can configure the FedEx shipping plugin to handle such products by following the guidelines for Hazmat packing provided in their knowledge base article here: https://www.pluginhive.com/knowledge-base/setting-woocommerce-fedex-shipping-plugin/#fedex_hazmat_packing. This will ensure your hydrogen therapy products are shipped correctly according to FedEx Hazmat shipping rules.

Does the PluginHive FedEx shipping plugin support generating Hazmat shipping documents like the OP-900?

Yes, the PluginHive FedEx shipping plugin generates the OP-900 document required for Hazmat shipments. This facilitates compliance with FedEx’s shipping regulations for hazardous materials. You can review the plugin’s Hazmat capabilities and demonstrate its workflow via the provided plugin demo website.

Can the WooCommerce FedEx Shipping Plugin bypass FedEx restrictions to allow home delivery of limited quantity lithium-ion batteries without hazardous goods surcharges?

  1. FedEx policy restricts limited quantity hazardous shipments to Express services only, excluding Ground (including Home Delivery).
  2. The plugin mirrors this behavior and cannot override FedEx’s restrictions or remove HazMat surcharges by selectively allowing Home Delivery for limited quantity products.
  3. Attempting to mark limited quantity lithium-ion batteries as non-hazardous to enable Home Delivery shipping would be non-compliant with FedEx regulations and risk improper shipment classification.
  4. For compliant and cost-accurate shipping of such products, users must accept FedEx Express service options returned by the plugin with applicable surcharges.

Can the WooCommerce FedEx Shipping Plugin be configured to support both Battery and Dangerous Goods (DG) configurations within a single product for different shipping services?

  1. A single product can be classified either as a Battery product or as a general Hazardous Material shipment, but not both in parallel.
  2. The plugin displays shipping services and rates based on the selected configuration, reflecting FedEx’s API limitations and shipping policies.
  3. This behavior is standard and consistent with FedEx service rules; customers have not commonly requested mixed classifications per product.
  4. Modifying this behavior to allow both options on one product would require custom development, which is offered as a paid customization starting at $500, depending on the scope of work.

Can the WooCommerce FedEx Shipping Plugin be configured to exclude Dangerous Goods (HazMat) surcharges for FedEx Home Delivery shipments of lithium-ion batteries, while still applying these surcharges to FedEx Air services?

  1. If a product is marked as hazardous (HazMat), FedEx only returns FedEx Ground service options, not FedEx Home Delivery or FedEx Air services. This is a deliberate FedEx-imposed limitation to comply with shipping regulations.
  2. The plugin reflects this limitation by only displaying FedEx Ground services with associated Dangerous Goods surcharges and residential delivery surcharges for hazardous shipments. No Home Delivery service options are returned for products classified as HazMat.
  3. Therefore, the plugin cannot differentiate to exclude HazMat surcharges specifically for Home Delivery shipping because Home Delivery options are not available at all for marked hazardous products through FedEx.
  4. Any higher rates seen for FedEx Ground including HazMat surcharges reflect FedEx’s official pricing policy for hazardous shipments; the plugin passes these rates transparently based on the FedEx API response.
  5. To ship lithium-ion batteries under any special small battery exception (such as UN3480 Section II limited quantity) that FedEx may allow without HazMat surcharges on Home Delivery, these products must not be marked as Dangerous Goods within the plugin, which means no HazMat-specific shipments or corresponding surcharges would be triggered.
  6. In summary, the plugin’s handling of hazardous shipments strictly follows FedEx’s service availability and surcharge application rules and cannot be customized to exclude HazMat charges for Home Delivery while applying them to Air because Home Delivery is not offered for HazMat products by FedEx.

How can I generate Hazmat shipments using the PluginHive FedEx plugin, and where do I set Hazmat details for my products?

Generating Hazmat shipments is supported by the PluginHive FedEx plugin by configuring Hazmat details at the product level. To set this up:

  1. Go to your WooCommerce product list and **Edit** the product for which you want to declare Hazmat status.
  2. Scroll to the **Shipping** tab within the product edit page.
  3. Locate the **FedEx Shipping details** section.
  4. Configure the appropriate Hazmat information for the product here.
  5. Once the product has its Hazmat details set, you can generate FedEx shipping labels for orders that include this product. The plugin will treat these shipments as Hazmat shipments.
  6. Ensure that your FedEx account is properly linked via the Compatible Registration process so Hazmat shipments can be processed correctly.

Looking for more details or ready to start using the plugin?
Visit the product page to explore all features and pricing.