---
title: namestring - X4 schema type
summary: namestring: 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

namestring: 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 | [`xs:string`](wiki:schema-xs-string-d5652e9b) |

| Constraint | Value |
| --- | --- |
| `pattern` | `[^']*` |

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_player_choice`](wiki:api-md-add-player-choice-2f756003) | `section` | `libraries/common.xsd` |
| [`cancel_conversation`](wiki:api-md-cancel-conversation-0d321cd3) | `conversation` | `libraries/common.xsd` |
| [`create_control_entity`](wiki:api-md-create-control-entity-14390534) | `group` | `libraries/common.xsd` |
| [`create_cue_actor`](wiki:api-md-create-cue-actor-6faf0094) | `group` | `libraries/md.xsd` |
| [`create_ship`](wiki:api-md-create-ship-a391ace8) | `group` | `libraries/common.xsd` |
| [`engine`](wiki:api-md-engine-0d7c15a7) | `macro` | `libraries/common.xsd` |
| [`engine`](wiki:api-md-engine-0d7c15a7) | `path` | `libraries/common.xsd` |
| [`engine`](wiki:api-md-engine-0d7c15a7) | `ammunition` | `libraries/common.xsd` |
| [`event_conversation_next_section`](wiki:api-mdevent-event-conversation-next-section-6daef6fe) | `sectionprefix` | `libraries/common.xsd` |
| [`event_conversation_returned_to_section`](wiki:api-mdevent-event-conversation-returned-to-section-015aa69d) | `sectionprefix` | `libraries/common.xsd` |
| [`event_conversation_started`](wiki:api-mdevent-event-conversation-started-f03035b6) | `convprefix` | `libraries/common.xsd` |
| [`include_interrupt_actions`](wiki:api-md-include-interrupt-actions-1690c778) | `ref` | `libraries/aiscripts.xsd` |
| [`open_conversation_menu`](wiki:api-md-open-conversation-menu-dc24d66b) | `menu` | `libraries/common.xsd` |
| [`pilot`](wiki:api-md-pilot-bf4d4c22) | `group` | `libraries/common.xsd` |
| [`select`](wiki:api-md-select-7d56c04d) | `macro` | `libraries/drops.xsd` |
| [`select`](wiki:api-md-select-7d56c04d) | `timeline` | `libraries/drops.xsd` |
| [`select`](wiki:api-md-select-7d56c04d) | `audiolog` | `libraries/drops.xsd` |
| [`set_conversation_return_section`](wiki:api-md-set-conversation-return-section-52e7ad90) | `section` | `libraries/common.xsd` |
| [`weapon`](wiki:api-md-weapon-63ca2303) | `macro` | `libraries/common.xsd` |
| [`weapon`](wiki:api-md-weapon-63ca2303) | `path` | `libraries/common.xsd` |
| [`weapon`](wiki:api-md-weapon-63ca2303) | `ammunition` | `libraries/common.xsd` |


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