PREREQUISITES: Make sure the Canada Post add-on is installed and enabled as described in Installing Add-ons from X-Cart App Store.

The regular way to configure the Canada Post add-on is to automatically port the settings into X-Cart by hitting the ‘Register’ button on the addon settings page. The procedure is described in detail here.


However, it may still be necessary to adjust some parcel characteristics afterward, or you may prefer to configure the add-on manually.

General Setup

To set up Canada Post manually:

  1. On the Shipping page of your X-Cart store’s Admin area (Store setup > Shipping), click the Add shipping method button.

  2. In the popup that appears, choose the Canada Post shipping method.

    This opens the Canada Post settings page.

  3. Click the Configure manually button to open the list of setting parameters available for configuration.

  4. Configure the settings.


    The page itself includes all possible parameters that you can set up for the Canada Post add-on divided into several sections.

    The page also provides a possibility to return to the main add-on settings page via the Enable merchant wizard link to set up the add-on automatically.


  5. Click Submit to make the configuration active.

Below is an explanation of the settings that you can find on the Canada Post manual configuration page.

Canada Post Settings

This section consists of the general parameters that define the related Canada Post account data (usually pre-defined if you used auto-setup), the mode the add-on is used in, and the ability to store logs on the server.


  • User and Password: These fields store your Canada Post merchant API key (username and password).

    The fields are filled in automatically in case the addon configuration has been completed using the Register button on the addon settings page. See more details on the automated add-on set-up here.

    It is also possible to define the fields’ values manually if required.

  • Developer mode: Enable it if you want to test the shipping method before making it live.

  • Log all communications between the shopping cart and UPS server: Enable if you want to have logs saved for future references.

Additional Settings

This section consists of the additional parameters that you can set up for your Canada Post account.


  • Quote type: Select the type of Canada Post rates you want to use in the store.

    • Commercial: contracted rates as agreed between you and Canada Post;

    • Counter: the rates you will get over the counter (without a customer or contract number).

  • Customer number: This field is intended for your Canada Post commercial customer number if you have one.

    This field fills in automatically if you have completed the Canada Post auto-setup.

    See the Canada Post website for more info:

  • Currency rate: This setting is needed for stores whose primary currency is other than the Canadian Dollar. Here you must specify a conversion rate for the currency used by your store (Specify rate X, where 1 CAD = X in shop currency).

Contract Shipping Options

This section provides settings that define the contract shipping options.


  • Contract ID: Your Canada Post contract number. This must be provided for commercial (contracted) rates if it exists. For non-contract rates, this will be empty.

    This field is pre-defined in the case of auto-setup.

  • Shipments pick up type: Specify whether you want Canada Post to pick up shipments at your business location (shipments are picked up by Canada Post) or whether you want to deliver your items to a post office from where they will be shipped further (deposit your items at a Post Office).

  • Site number of the deposit location: Specify the site number from your Canada Post account. (Look up the site number using )Find a Deposit Location

  • Render detailed manifest: Specify whether you need a full detailed manifest document to be rendered (Yes) or a summarized manifest document to be rendered (No).

  • Contact name for the manifest address: Specify the name that should be used for your manifest address (Character string up to 44 characters; will be printed on the manifest document).

Deliver to Post Office Options

This section provides settings that define delivery options to post offices.


  • Enable the “Deliver to Post Office” feature: Enable this to allow your buyers to get their purchases at a nearby post office location of their choice.

    The "Deliver to Post Office" option is available only with Xpresspost and Expedited Parcel Services.

  • Maximum Post Offices that Will Be Displayed: Specify the maximum number of post offices that should display for selection to a buyer who chose to use the “Deliver to Post Office” option.

Parcel Characteristics

The settings in this section allow you to specify the typical characteristics of a parcel that you will send from your store via Canada Post. The characteristics specified here will be used as the default values for configuring shipments; if necessary, you will be able to edit these values for specific shipments.


  • Package length (cm): The longest dimension of the parcel in cm (Numeric field, 999.9 patterns).

  • Package width (cm): Second longest dimension of the parcel in cm (Numeric field, 999.9 patterns).

  • Package height (cm): The shortest dimension of the parcel in cm (Numeric field, 999.9 patterns).

  • Package maximum weight (kg): Maximum total weight of the parcel. This value will be used to separate the items ordered by a buyer into several parcels based on weight.

  • Document: Indicates whether the shipment is a document or not.

  • Unpackaged: Indicates whether the shipment is unpackaged or not. For example, auto tires may be an example of an unpackaged shipment.

  • Mailing tube: Indicates whether the shipment is contained in a mailing tube. (e.g., a poster tube)

  • Oversized: - Indicates whether the parcel is oversized or not. If parcel dimensions have been provided, then this element will be automatically determined (as either true or false) based on the parcel dimensions (regardless of whether you include a value for the “oversized” element field). However, if no dimensions are provided, then you can specify that a parcel is oversized (or not) using this element.

Please note that currently, X-Cart’s Canada Post add-on does not support the use of package dimensions (Package length, Package width, and Package height) for rate calculation and for splitting a single order into multiple packages; only the Package maximum weight value and the weight of the products in the order are taken into account.

Parcel Options

The settings in this section allow you to specify the default option values for your Canada Post shipments.


  • Way to deliver: Use this to provide special instructions as to how the parcel should be delivered. You can choose one of the following options:

    • Not specified

    • Card (hold) for pick up: This option is ideal for shipments containing temperature-sensitive items. It means that the parcel will be marked “Card for Pickup” to ensure that Canada Post does not deliver it; instead, Canada Post will notify the addressee that the parcel is to be picked up at the post office. In addition, Canada Post will require the addressee or a representative to show one valid piece of government-issued photo identification when picking up the item.

    • Leave at door: This option is only available for items that are usually delivered to the door. A delivery attempt will be made at the door. If no one is available and the item fits, it will be left in the addressee’s mail receptacle. If the item does not fit or the mail receptacle is full, and there is a safe drop location (an appropriate safe place where the item is sheltered from the weather and not seen by passers-by), a courier will safely drop the item. The courier will also leave a Safe Drop Card indicating the location of the safe drop in the addressee’s mail receptacle at the time of delivery. If a safe drop is not possible, a courier will leave a Delivery Notice Card, and the item will be available for pickup at the designated post office.

    • Do not safe drop: This option only changes the delivery process for items where a delivery attempt is made at the door. A courier will leave the item in the addressee’s mail receptacle. If the item does not fit, a delivery attempt will be made at the door. If no one is available to receive the item, the courier will leave a Delivery Notice Card, and the addressee will be able to pick up the item at the designated post office.

  • Signature: Enable this option if you want the recipient’s signature to be collected at delivery. Signature ensures that a personal hand-off of the item occurs at delivery and provides proof of this activity.

  • Proof of age: If you require the Proof of Age option, specify the age that a parcel recipient must be in order to receive the shipment. The following options are available:

    • Not specified

    • 18 years

    • 19 years: The “Proof of age” option ensures that, when the receiver appears to be less than 25 years of age, Canada Post will request a photo identification proving age and will record the signature and name of the signatory. Canada Post will only hand the item over to a person with an acceptable identification (ID) proving the age of the majority.

      See Canada Postal Guide under Policies for a list of the age of majority identification by province or territory.

  • Coverage: If you need insurance for your parcels, use this field to specify the coverage amount as a percentage of the order subtotal. Set this value to “0” (zero) if you do not need coverage.

  • Non-delivery instructions: Specify what you would like to be done about your parcel in the event that delivery cannot be completed (required for some U.S.A. and international shipments). Choose one of the following options:

    • Not specified

    • Return at Sender’s Expense

    • Return to Sender

    • Abandon: The parcel will not be returned but will be disposed of by Canada Post.

For detailed information on Canada Post rules and practices, please refer to the Canada Postal Guide.

Did this answer your question?