---
title: ware - X4 schema type
summary: ware: X4 attribute schema type: base types, constraints and value alternatives.
section: reference
kind: guide
status: reference
updated: 2026-10-27
tags: ["XSD","schema","types"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/","https://www.w3.org/TR/xmlschema11-2/"]
---
## Meaning

ware: X4 attribute schema type: base types, constraints and value alternatives.

An XSD type constrains XML, rather than declaring a Lua return or the payload type of event.param. A valid schema value does not prove a successful game effect.

## Schema structure

`libraries/common.xsd`

| Property | Value |
| --- | --- |
| Construction | `restriction` |
| Base type | [`expression`](wiki:schema-expression-b8bc0e4f) |

restriction narrows a base type; union accepts one of its branches; list describes whitespace-separated items. Enumeration values in one restriction are alternatives. Pattern syntax is XML Schema regex, not Lua patterns or JavaScript RegExp. Constraints inherited from the base type still apply.

## Example and result

Use the attribute pages below for contextual examples. A generic executable example is not inferred from a type name alone.

## Used by

| Element | Attribute | Schema |
| --- | --- | --- |
| [`add_cargo`](wiki:api-md-add-cargo-d6b6d899) | `ware` | `libraries/common.xsd` |
| [`add_inventory`](wiki:api-md-add-inventory-63e96ff6) | `ware` | `libraries/common.xsd` |
| [`create_trade_offer`](wiki:api-md-create-trade-offer-d9bc6d87) | `ware` | `libraries/common.xsd` |
| [`downgrade_software`](wiki:api-md-downgrade-software-3b6c1586) | `software` | `libraries/common.xsd` |
| [`event_trade_completed`](wiki:api-mdevent-event-trade-completed-6c57c245) | `ware` | `libraries/common.xsd` |
| [`find_buy_offer`](wiki:api-md-find-buy-offer-2b617170) | `wares` | `libraries/common.xsd` |
| [`find_sell_offer`](wiki:api-md-find-sell-offer-720d9012) | `wares` | `libraries/common.xsd` |
| [`install_software`](wiki:api-md-install-software-159ae6ae) | `software` | `libraries/common.xsd` |
| [`remove_cargo`](wiki:api-md-remove-cargo-c02ea811) | `ware` | `libraries/common.xsd` |
| [`remove_inventory`](wiki:api-md-remove-inventory-c0df5d23) | `ware` | `libraries/common.xsd` |
| [`uninstall_software`](wiki:api-md-uninstall-software-2fc2d363) | `software` | `libraries/common.xsd` |


[All schema types](wiki:schema-types) · [Lua / MD value types](wiki:types)