Open Settings → Plugins → Foxpost (or the Foxpost → Settings control
panel nav item once the plugin is enabled). Settings are organised into tabs;
the shared General, Details, Table Rates, and Restrictions
tabs come from yStore's common shipping-method settings (price, free-shipping
threshold, visibility, payment-method restrictions) and apply to Foxpost the
same way they apply to other shipping plugins.
API
| Field | Description |
|---|
| Sandbox mode | Sends all API traffic to Foxpost's test environment instead of production. Use this while validating credentials, labels, and tracking before going live. |
| API Username | Foxpost API username. |
| API Password | Foxpost API password. |
| API Key (x-api-key) | Foxpost API key, sent as the x-api-key header on every request. |
Use Test Connection (top of the settings page) after entering credentials
to verify them against Foxpost before saving -- it calls the API immediately
and reports whether the credentials are valid.
Shipping
| Field | Description |
|---|
| Auto-sync shipments | When enabled, a Foxpost shipment is created automatically as orders change status, instead of relying on the manual "create shipment" action on the order edit page. |
| Tracking update interval (hours) | How often the scheduled task refreshes tracking status for open shipments; 0 disables the scheduled refresh (tracking can still be refreshed manually or via the console command). |
| Foxpost Account Address (Sender) | Pick a sender address already stored in the connected Foxpost account (see Addresses). Takes precedence over the manual sender fields below when set. |
| Sender Name, Phone, Email, ZIP Code, City, Street & House Number | Manual sender address, used only when no Foxpost Account Address is selected. Sent as the sender on every shipment; an incomplete sender address will cause label generation to fail. |
Labels
| Field | Description |
|---|
| Default Label Format | A6, A7, 85×85 (thermal), or A4 (multi-label) -- the label size requested when a format isn't explicitly given at download time. |
| Default Parcel Size | XS–XL, or unset, used as the parcel size hint for new shipments. |
Returns
| Field | Description |
|---|
| Enable Returns | Turns on the FoxPost Return action menu on the order edit page. |
| Return Address | Which Foxpost Account Address (see Addresses) to use as the return address for returns created through the order edit page. |
Addresses
Manages the address book stored in the connected Foxpost account -- list,
add, or remove addresses (with a name, type such as HQ/SITE/RETURN,
contact details, and postal address). These account addresses are what the
Foxpost Account Address (Sender) field (Shipping tab) and Return
Address field (Returns tab) pick from; the tab itself has no separate
settings to save.
Controls the checkout-facing map/list picker (see
How it works):
| Field | Description |
|---|
| Display Discounted Parcels | Includes parcel lockers running a Foxpost discount promotion in the widget results. |
| Display Map | Shows the map widget at all; when off, only the in-page list picker is available. |
| Theme | Light or Dark -- passed through to the map widget iframe. |
| Language | Widget display language (currently Hungarian or English). |
| Show Map on Desktop / Tablet / Mobile | Per-device toggle for whether the map widget renders on that viewport. |
| Map Height (Desktop / Tablet / Mobile) | Pixel height of the map widget iframe for that viewport, used only when the map is shown on it. |
Where this is used
- API, Shipping, and Labels settings apply to every shipment
created, whether triggered manually or automatically.
- Returns settings only take effect once Enable Returns is on.
- Addresses only matters when a Foxpost Account Address is selected as
the sender (Shipping tab) or the return address (Returns tab).
- Widget settings only affect stores where Foxpost is an active/visible
shipping method at checkout.
- See the Foxpost overview for end-to-end examples covering
automatic shipment creation with locker checkout, and creating a return
from the order edit page.