Field Mapping

Field mapping defines how API response data becomes available in YOOtheme Pro's dynamic content system.

How Field Mapping Works

API returns JSON data
You define which fields to extract
API Mapper makes those fields available as YOOtheme sources
You use them in your page builder elements

Adding Fields

Open your connection settings
Go to the Fields section
Click Add Field
Configure the field:
- Name: Display name in YOOtheme (e.g., "Product Title")
- Path: JSON path to the data (e.g., title or product.name)
- Type: Data type (Text, Number, Image, etc.)

Field Types

Type	Use For	Example
Text	Strings, descriptions	Product name, article body
Number	Numeric values	Price, quantity, ID
Image	Image URLs	Product image, thumbnail
Link	URLs	Product link, website
Date	Date/time values	Published date, event date
Boolean	True/false values	In stock, featured

JSON Path Syntax

Simple Paths

For top-level fields:

{
  "title": "My Product",
  "price": 29.99
}

Path: title → "My Product"
Path: price → 29.99

Nested Paths

For nested objects, use dot notation:

{
  "product": {
    "name": "Widget",
    "details": {
      "sku": "WGT-001"
    }
  }
}

Path: product.name → "Widget"
Path: product.details.sku → "WGT-001"

Array Items

For arrays, API Mapper automatically iterates:

{
  "items": [
    {"name": "Item 1", "price": 10},
    {"name": "Item 2", "price": 20}
  ]
}

Path: items[].name → Available for each item
Path: items[].price → Available for each item

JMESPath Transforms (Pro)

Pro Feature

JMESPath transforms require a Pro or Developer license.

For complex data transformations, use JMESPath expressions:

# Filter items by status
items[?status=='active']

# Get first 5 items
items[:5]

# Sort by price
sort_by(items, &price)

# Extract specific fields
items[].{name: title, cost: price}