About FQDNs

A Fully Qualified Domain Name (FQDN) is a unique identifier for each Wix service object. Think of it as the "address" that tells Wix exactly which service object you want to work with.

FQDN structure

FQDNs follow this structure: wix.<domain>.<product>.<version>.<service_object>

Wildcards

When working with data extension schemas or other APIs that accept FQDNs, you can use wildcards (*) instead of specific version numbers to prevent issues when service objects are updated to newer versions. For example: wix.<domain>.<product>.*.<service_object>

This ensures your code continues to work when Wix updates the service object to a newer version (for example, wix.ecom.v2.order), without requiring you to update your implementation.

Examples:

• wix.ecom.*.order - Wix eCommerce Order service object (any version)
• wix.ecom.v1.checkout - Wix eCommerce Checkout service object
• wix.ecom.v1.cart - Wix eCommerce Cart service object
• wix.multilingual.machine.*.translatable_content - Wix Multilingual Machine Translation service object (any version)

When to use FQDNs

You'll need FQDNs when:

• Working with data extension schemas to specify which service object you want to extend with site-specific custom fields. See Data Extension Schema API.
• Using schema plugins to define which service objects your plugin extends. See About Schema Plugin Extensions.
• Calling certain APIs to identify the specific service object type. For example, List Data Extension Schemas requires an FQDN parameter.
• Processing events to understand which service object triggered the event. See Webhooks.

Finding FQDNs

FQDNs are available in event payloads. Events that return FQDNs will have the entityFqdn field documented in their event reference, and the FQDN is returned as entityFqdn in the event data.