WPRuby Logo WPRuby
Log in Get started
  • Plugins
  • Themes
  • Docs
  • Blog
    • eCommerce
    • Plugins
    • How to
    • Coding
  • Affiliate Area
  • Contact Us
  • About Us
  • Plugins
  • Themes
  • Docs
  • Blog
    • eCommerce
    • Plugins
    • How to
    • Coding
  • Affiliate Area
  • Contact Us
  • About Us

WPRuby Account

4
  • How to upgrade your license
  • How to renew your license
  • How to change your plugin’s license domain
  • How to cancel your subscription.

WooCommerce Australia Post Shipping Method Pro

14
  • Installation
  • How to activate your Australia Post Pro license
  • How to Upgrade from Free to Pro
  • Australia Post Zone Settings
  • Australia Post Global Settings
  • Australia Post Tracking
  • Pre-Paid Satchels
  • How to Mark a Product to be Shipped Individually?
  • TroubleShooting and Common issues
  • Available WordPress Actions and Filters
  • [Labels Pro] How to connect the plugin with your MyPost Business account
  • [Labels Pro] How to connect Labels Pro with your eParcel account
  • [Labels Pro] How to print labels and create shipping orders.
  • [Labels Pro] How to Mark a Product as Containing Hazardous Materials?

WooCommerce Custom Payment Gateway Pro

11
  • Getting Started
  • Custom Payment Gateway Settings
  • Custom Checkout Field Builder
  • Conditional Display Rules
  • Sending Payment Data to an External API
  • How to Create a Pay by Invoice Payment Method
  • How to Create a Manual Payment Link or Review-Based Payment Method
  • Troubleshooting
  • Frequently Asked Questions
  • Security and Sensitive Payment Data
  • How to Upgrade from Free to Pro

WooCommerce Royal Mail Shipping Calculator Pro

4
  • Installation
  • Settings
  • TroubleShooting and Common issues
  • How to activate your plugin license

Controlled Admin Access Pro

3
  • Available Actions for a Restricted Admin
  • Installation
  • Settings

WooCommerce Address Guard Pro

7
  • Get Started
  • Configuring Address Providers
  • Configuring Checkout Validation
  • Creating Address Rules
  • Customizing Customer Messages
  • Using the Address Tester
  • Reviewing Address Quality Inside WooCommerce Orders

WooCommerce Simple Table Rates Pro

8
  • Installation
  • Settings
  • Rules and Actions
  • How to Setup Weight Based Shipping
  • How To Setup Shipping By Shipping Class
  • How to Setup Shipping by Cart Total
  • How to Setup Shipping by Product
  • How to Setup Shipping by Product Category

WooCommerce Pack IQ

5
  • Installation
  • How to activate your plugin license
  • How to add a new box
  • How to change the boxes weight and dimensions units
  • How to view the packing results

WooCommerce Restricted Shipping and Payment Pro

4
  • Installation
  • Setting Up Shipping Methods Conditions
  • Available Shipping & Payment Rules
  • Setting Up Payment Gateways Conditions

Affiliate Butler PRO

11
  • Installation and Upgrade
  • Quick Start Guide
  • Managing Auto Links
  • Link Types
  • Short Links
  • Auto Link in the Block Editor
  • Statistics
  • Import and Export
  • Settings
  • Frequently Asked Questions
  • Developers

WooCommerce Adyen Payment Gateway

2
  • Setup the Adyen payment gateway
  • How to configure Adyen Webhook notifications? 

WooCommerce Free Shipping Per Product

2
  • Installation
  • How to setup free shipping for a certain product

WooCommerce UPS Shipping Method Pro

10
  • Installation
  • How to get your UPS Client ID and Client Secret
  • UPS Center Settings
  • UPS Zone Settings
  • How to ship an order and print UPS labels
  • Managing UPS shipments
  • UPS tracking numbers and order completion
  • Shipping Health checks
  • How to activate your UPS license
  • Troubleshooting common issues

Delivery Promise for WooCommerce

9
  • Getting Started
  • Understanding Processing Time vs Transit Time
  • Setting the Cutoff Countdown
  • Configuring Default Delivery Estimates
  • Creating Delivery Rules
  • Setting Working Days and Holidays
  • Using Rule Presets
  • Product-Level Lead Times
  • Why the “Order Within” Countdown Is Not Showing

Cartavera

16
  • Cartavera documentation
  • Install Cartavera
  • Activate your licence
  • Import a starter site
  • Styles, colours and fonts
  • Headers and footers
  • The homepage
  • Catalog and filters
  • The product page
  • Cart and checkout
  • Translation and right-to-left languages
  • Child themes
  • Hooks and filters reference
  • Troubleshooting
  • FAQ
  • Changelog

Candy Shop

14
  • Candy Shop documentation
  • Install Candy Shop
  • Activate your licence
  • Import a starter site
  • Set up your products
  • Food information and allergens
  • Shop pages and filters
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage
  • Child theme
  • Hooks and filters
  • FAQ
  • Changelog

Foliowick

16
  • Foliowick documentation
  • Install Foliowick
  • Activate your licence
  • Import a demo store
  • Authors and author pages
  • Book details and editions
  • Genres, reading lists and the Editor’s Pick
  • Secondhand copies and forthcoming books
  • Shop pages, search and book pages
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage
  • The journal and editorial pages
  • Hooks and filters
  • FAQ
  • Changelog

Gemelune

14
  • Gemelune documentation
  • Install Gemelune
  • Activate your licence
  • Import a starter site
  • Metals, sizes and swatches
  • Size guide, delivery and care pages
  • Shop pages, product cards and product pages
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage
  • Child theme
  • Hooks and filters
  • FAQ
  • Changelog

Formafern

15
  • Formafern documentation
  • Install Formafern
  • Activate your licence
  • Import the demo store
  • Finishes and swatches
  • Dimensions, materials and care
  • Rooms and Shop the Room
  • Shop pages, product cards and product pages
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage and editorial pages
  • Child theme
  • Hooks and filters
  • FAQ
  • Changelog

Pawtani

15
  • Pawtani documentation
  • Install Pawtani
  • Activate your licence
  • Install a starter site
  • Pets, sizes, flavours and product facts
  • Size & fit guides
  • Shop pages, filters and product pages
  • Repeat purchases, subscriptions and wishlists
  • Styles, colors and fonts
  • Headers, footers and menus
  • The homepage
  • Child theme
  • Hooks and filters
  • FAQ
  • Changelog

Deep Insights for WooCommerce

19
  • Getting Started with Deep Insights for WooCommerce
  • Upgrading from Woo Insights
  • Importing Your Order History
  • Dates, Comparisons and Filters
  • Revenue Report
  • Products Reports
  • Customer Reports
  • RFM Customer Segments
  • Retention and Cohorts
  • Profitability and Cost of Goods
  • Subscriptions Analytics
  • Inventory Intelligence
  • Shipping, Discounts and Refunds
  • Automated Insights
  • Settings Reference
  • Why Numbers Can Differ from WooCommerce Analytics
  • Troubleshooting
  • Privacy, Security and Updates
  • Developer Hooks
WooCommerce GLS Canada Shipping Pro

WooCommerce GLS Canada Shipping Pro

11
  • Installation
  • How to get your GLS Canada API access
  • GLS Canada Centre settings
  • Adding GLS Canada to a shipping zone
  • How to create a GLS shipment and print the label
  • Creating GLS labels in bulk
  • Requesting GLS pickups
  • GLS tracking for you and your customers
  • Shipping Health checks
  • How to activate your GLS Canada license
  • Troubleshooting common issues
WooCommerce Canada Post Extension PRO

WooCommerce Canada Post Extension PRO

17
  • Installation
  • Demo mode, Test API mode and going live
  • How to connect your Canada Post account
  • Canada Post settings
  • Adding Canada Post to a shipping zone
  • Boxes, packing and product shipping options
  • Canada Post at checkout: rates, Deliver to Post Office and address lookup
  • How to create a Canada Post shipment and print the label
  • International shipments and customs
  • Creating Canada Post labels in bulk
  • Manifests: closing out the day
  • Canada Post tracking for you and your customers
  • Canada Post returns
  • Requesting Canada Post pickups
  • Dashboard, Shipments, Rate Calculator and Post Offices
  • How to activate your Canada Post licence
  • Troubleshooting common issues
View Categories
  • Home
  • Knowledge Base
  • WooCommerce GLS Canada Shipping Pro
  • Troubleshooting common issues

Troubleshooting common issues

Waseem
Updated on November 21, 2026

3 min read

0:00 / 3:06
  • View as Markdown Open this page as plain Markdown (opens in a new tab)
  • Open in ChatGPT Ask questions about this page (opens in a new tab)
  • Open in Claude Ask questions about this page (opens in a new tab)
  • Open in Google AI Studio Ask questions about this page (Google account required) (opens in a new tab)

Start with Shipping Health: it checks the credentials, API connection, sender address, shipping zones, product data, currency, background jobs and label storage. For more detail, turn on Settings → Advanced → Debug logging and check WooCommerce → Status → Logs (source gls-canada). Passwords and personal data are redacted in the logs. The last GLS error for an order is shown in the Label Printer and in the order’s GLS Canada box.

Table of Contents

Toggle
  • GLS Canada rejected the API username or password (401)
  • Missing a role or permission (403)
  • The billing account does not exist for the Parcel category
  • No GLS rates at checkout
  • Only GLS Ground is offered
  • GLS Canada rejected the request (400)
  • This order already has a GLS shipment
  • Live shipment creation is locked
  • Shipment created, but the label could not be downloaded
  • This shipment is part of a pickup (when voiding)
  • Tracking says "Awaiting pickup" for a long time
  • Tracking never updates
  • The PHP zip extension is required
  • The GLS Canada API did not respond in time
  • The license will not activate
  • Label files on nginx

GLS Canada rejected the API username or password (401)

Check the password and that you chose the right environment (Sandbox or Production). If they are correct, GLS Canada may not have enabled API access yet: email [email protected].

Missing a role or permission (403)

Your GLS user lacks a permission, for example "Rate View" for negotiated rates. Ask GLS Canada to grant it on your billing account.

The billing account does not exist for the Parcel category

Use your 6-digit Parcel billing account and ask GLS Canada to link it to your login.

No GLS rates at checkout

Check that GLS Canada is in the shipping zone, the address is in Canada with a valid postal code, the credentials and sender address are saved, and products have a weight (or set a default weight). Turn on Debug logging: store managers then see the reason at checkout.

Only GLS Ground is offered

GLS Air needs parcel dimensions. Add product dimensions, custom boxes or default parcel dimensions.

GLS Canada rejected the request (400)

Read the details under the message (for example an invalid postal code). If GLS requires references for your account, Test Connection lists them; set the Order reference type in Settings → Shipping Labels.

This order already has a GLS shipment

Void the existing shipment, or tick "Yes, create another billable shipment for this order".

Live shipment creation is locked

Production is selected but not confirmed. An administrator turns on Confirm live shipments in Settings → Account.

Shipment created, but the label could not be downloaded

Click Re-download from GLS in the Label Printer. It only downloads the label and never creates a new shipment.

This shipment is part of a pickup (when voiding)

GLS only deletes shipments that are not in a pickup. Delete the pickup in Labels Orders first.

Tracking says "Awaiting pickup" for a long time

Request a pickup for the shipment, then use Refresh tracking later.

Tracking never updates

Check WooCommerce → Status → Scheduled Actions for glsca_tracking_sync; WP-Cron must be running.

The PHP zip extension is required

Bulk label downloads need the PHP zip extension. Ask your host to enable it, or download labels per order.

The GLS Canada API did not respond in time

Increase the API timeout in Settings → Advanced.

The license will not activate

"Reached its site limit": deactivate the license on a site you no longer use. "For a different WPRuby plugin": use your GLS Canada key. "Could not be reached": your site cannot connect to wpruby.com; check your firewall or proxy. Shipping keeps working meanwhile.

Label files on nginx

Labels are stored in wp-content/uploads/glsca-labels/ with random names and are only served to logged-in staff. nginx ignores .htaccess; add location ~* /wp-content/uploads/glsca-labels/ { deny all; } to your server configuration.

Still stuck? Contact WPRuby support and attach the (redacted) log.

How to activate your GLS Canada licenseInstallation
WPRuby Logo WPRuby

In 2015, WPRuby was established as an independent agency where we focus on producing and supporting many WordPress plugins. Each product we develop is simple to use and easy to customize and backed by awesome support and regular updates.

Resources

  • Knowledge Base
  • Affiliate Area
  • About Us
  • Nomad Jar
  • GarnerDocs
  • UnavailableToday

Legal

  • Privacy Policy
  • Terms of Use

Follow us

  • Github
  • X.com
  • LinkedIn
  • Facebook

© 2026 - WPRuby