Settings
Open Settings → Plugins → GLS (or the GLS → Settings control panel nav item once the plugin is enabled).
Connection
| Field | Description |
|---|---|
| Sandbox mode | Use GLS's dedicated sandbox endpoint instead of the production API. Use this while validating credentials, labels, and tracking before going live. |
| Client Number | The unique client number GLS assigns for API access. |
| Username / Password | Production API credentials provided by GLS. |
| API URL | Production ParcelService endpoint, defaults to https://api.mygls.hu/ParcelService.svc/json/. Only shown in advanced mode; change it to the country-specific domain (.sk, .cz, etc.) matching the GLS account. |
| Sandbox API URL | Sandbox endpoint used only while Sandbox mode is on. |
| Sandbox client number, Sandbox username, Sandbox password | Separate sandbox credentials, used only while Sandbox mode is on. |
GLS supports multiple country-specific domains. Make sure the API URL matches the country the account was issued for.
Use Test Credentials after entering credentials to verify them against GLS before relying on them at checkout -- it calls the API immediately and reports whether the credentials are valid.
Pickup address
This address is sent as the sender on every GLS shipment: pickup name, contact name, contact email, contact phone, street, house number, house number info, city, ZIP code, and ISO country code. Of these, name, street, city, ZIP code, and ISO country code are required -- saving the settings while the plugin is enabled fails if any of them is missing. Contact name, contact email, contact phone, house number, and house number info are optional.
Shipment defaults
| Field | Description |
|---|---|
| Default parcel weight (kg) | Used when an order does not specify a weight. |
| Default length / width / height (cm) | Package dimensions applied when an order doesn't carry its own dimensions. |
| Default service code | Optional GLS service code applied to every created parcel. Leave empty to use GLS's default service. |
| Maximum shipping labels per order | Restricts how many GLS labels can be generated for a single order. Manual and automatic shipment creation are both blocked once this limit is reached. |
Label printing
| Field | Description |
|---|---|
| Default label format | The label type requested when printing shipping labels (for example a PDF sheet layout such as A4_2x2, or a ZPL format for thermal printers). |
| Label sheet start position | The starting slot used when printing on multi-position GLS label sheets, useful for reusing a partially printed sheet. |
Automation
| Field | Description |
|---|---|
| Sync on order status | When an order reaches this status, the shipping data is automatically sent to GLS and a shipment is created. Leave as — Select status — to only create shipments manually from the order edit page. |
Control panel
| Field | Description |
|---|---|
| Enable control panel navigation | Toggles the GLS section (Dashboard, Shipments, Labels, Settings) in the Craft control panel navigation. Turning this off hides the section but does not disable the shipping method itself. |
Shared shipping fields
Because GLS extends yStore's common shipping settings, the standard shipping fields also apply here: display name, checkout instructions, price, currency, free-shipping threshold, allowed countries, weight restrictions, visibility window (visible from/to), and allowed payment methods. These behave the same way as on any other yStore shipping plugin.
Where this is used
- Connection, pickup address, and shipment-default settings apply to every shipment created, whether triggered manually or automatically.
- Checkout-facing settings (price, restrictions, visibility window) only affect stores where GLS is an active/visible shipping method.
- See the GLS overview for end-to-end examples of both a fully automated setup and manual shipment creation.