Product Metafields

This page documents all product-level metafields populated by PromoSync. All fields use the psrestful namespace.

Basic Information

supplier_code

PromoStandards supplier code.

Property	Value
Namespace	`psrestful`
Key	`supplier_code`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.supplier_code }}
→ "SanMar"{% endraw %}

product_id

Product ID from PromoStandards.

Property	Value
Namespace	`psrestful`
Key	`product_id`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.product_id }}
→ "3001"{% endraw %}

extra_id

Extra ID from PSRESTful API.

Property	Value
Namespace	`psrestful`
Key	`extra_id`
Type	`number_integer`

{% raw %}{{ product.metafields.psrestful.extra_id }}
→ 12345{% endraw %}

brand

Brand of the product.

Property	Value
Namespace	`psrestful`
Key	`brand`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.brand }}
→ "BELLA+CANVAS"{% endraw %}

line_name

Line Name / Division to which this product belongs.

Property	Value
Namespace	`psrestful`
Key	`line_name`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.line_name }}
→ "Bella Canvas Premium"{% endraw %}

Availability & Ordering

effective_date

The date this product initially becomes available from the supplier (ISO 8601 format).

Property	Value
Namespace	`psrestful`
Key	`effective_date`
Type	`date_time`

{% raw %}{{ product.metafields.psrestful.effective_date | date: "%B %d, %Y" }}
→ "January 15, 2024"{% endraw %}

minimum_quantity

Minimum quantity to order.

Property	Value
Namespace	`psrestful`
Key	`minimum_quantity`
Type	`number_integer`

{% raw %}{{ product.metafields.psrestful.minimum_quantity }}
→ 24{% endraw %}

lead_time

Lead time in days.

Property	Value
Namespace	`psrestful`
Key	`lead_time`
Type	`number_integer`

{% raw %}{% assign lead = product.metafields.psrestful.lead_time %}
{% if lead %}
  Ships in {{ lead }} business days
{% endif %}{% endraw %}

is_on_demand

Product is available on demand.

Property	Value
Namespace	`psrestful`
Key	`is_on_demand`
Type	`boolean`

{% raw %}{% if product.metafields.psrestful.is_on_demand %}
  <span class="badge">Made to Order</span>
{% endif %}{% endraw %}

is_rush_service

Product is available as a rush service.

Property	Value
Namespace	`psrestful`
Key	`is_rush_service`
Type	`boolean`

{% raw %}{% if product.metafields.psrestful.is_rush_service %}
  <span class="badge">Rush Available</span>
{% endif %}{% endraw %}

export

Product status for export.

Property	Value
Namespace	`psrestful`
Key	`export`
Type	`boolean`

{% raw %}{{ product.metafields.psrestful.export }}
→ true{% endraw %}

Product Details

primary_material

Primary material of construction.

Property	Value
Namespace	`psrestful`
Key	`primary_material`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.primary_material }}
→ "100% Airlume combed and ring-spun cotton"{% endraw %}

country_of_origin

Country of origin of the product.

Property	Value
Namespace	`psrestful`
Key	`country_of_origin`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.country_of_origin }}
→ "Honduras"{% endraw %}

features

Features of the product.

Property	Value
Namespace	`psrestful`
Key	`features`
Type	`multi_line_text_field`

{% raw %}{{ product.metafields.psrestful.features }}
→ "Side-seamed
Shoulder-to-shoulder taping
Tear-away label"{% endraw %}

care_instructions

Care instructions for the product.

Property	Value
Namespace	`psrestful`
Key	`care_instructions`
Type	`multi_line_text_field`

{% raw %}{{ product.metafields.psrestful.care_instructions }}
→ "Machine wash cold, tumble dry low"{% endraw %}

Decoration & Imprint

location_decorations

An array containing a list of locations with applicable decoration methods.

Property	Value
Namespace	`psrestful`
Key	`location_decorations`
Type	`json`

[
  {
    "locationId": 70,
    "decorations": [
      {
        "default": false,
        "decorationId": 950,
        "priceIncludes": false,
        "decorationName": "Embroidery",
        "maxImprintColors": 99
      }
    ],
    "locationName": "FRONT",
    "locationRank": 2,
    "maxDecoration": 0,
    "minDecoration": 0,
    "defaultLocation": false,
    "decorationsIncluded": 0
  }
]

{% raw %}{% assign locations = product.metafields.psrestful.location_decorations.value %}
{% if locations %}
  <div class="decoration-options">
    {% for location in locations %}
      <div class="location">
        <strong>{{ location.locationName }}</strong>
        <ul>
          {% for dec in location.decorations %}
            <li>{{ dec.decorationName }}{% if dec.maxImprintColors %} (up to {{ dec.maxImprintColors }} colors){% endif %}</li>
          {% endfor %}
        </ul>
      </div>
    {% endfor %}
  </div>
{% endif %}{% endraw %}

imprint_size

The imprint size for decoration.

Property	Value
Namespace	`psrestful`
Key	`imprint_size`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.imprint_size }}
→ "4\" x 4\""{% endraw %}

default_set_up_charge

The default setup charge for this product. Can be a textual description.

Property	Value
Namespace	`psrestful`
Key	`default_set_up_charge`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.default_set_up_charge }}
→ "$50.00" or "50.00(G)"{% endraw %}

default_run_charge

The default run charge for this product. Can be a textual description.

Property	Value
Namespace	`psrestful`
Key	`default_run_charge`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.default_run_charge }}
→ "$2.50" or "Included"{% endraw %}

charge_type

Charge type of the product (e.g., “Setup”, “Run Charge”, “Order”).

Property	Value
Namespace	`psrestful`
Key	`charge_type`
Type	`single_line_text_field`

{% raw %}{{ product.metafields.psrestful.charge_type }}
→ "Setup"{% endraw %}

Pricing

price_expires_date

The date this product’s pricing expires.

Property	Value
Namespace	`psrestful`
Key	`price_expires_date`
Type	`date_time`

{% raw %}{% assign expires = product.metafields.psrestful.price_expires_date %}
{% if expires %}
  <p class="price-notice">Pricing valid until {{ expires | date: "%B %d, %Y" }}</p>
{% endif %}{% endraw %}

Compliance & Safety

is_caution

Cautionary status to review for specific warnings about using product data.

Property	Value
Namespace	`psrestful`
Key	`is_caution`
Type	`boolean`

{% raw %}{% if product.metafields.psrestful.is_caution %}
  <div class="caution-notice">
    ⚠️ Please review product warnings before ordering
  </div>
{% endif %}{% endraw %}

caution_comment

Caution details and warnings.

Property	Value
Namespace	`psrestful`
Key	`caution_comment`
Type	`multi_line_text_field`

{% raw %}{% assign caution = product.metafields.psrestful.caution_comment %}
{% if caution %}
  <div class="warning">{{ caution }}</div>
{% endif %}{% endraw %}

is_hazmat

Contains hazardous material. A nil value indicates this is unknown or the data is not available from the supplier.

Property	Value
Namespace	`psrestful`
Key	`is_hazmat`
Type	`boolean`

{% raw %}{% if product.metafields.psrestful.is_hazmat %}
  <div class="hazmat-warning">
    ⚠️ This product contains hazardous materials
  </div>
{% endif %}{% endraw %}

unspsc_commodity_code

The United Nations Standard Products and Services Code (UNSPSC) that best describes this product. These are the UNSPSC “Commodity” codes. For more information, refer to unspsc.org.

Property	Value
Namespace	`psrestful`
Key	`unspsc_commodity_code`
Type	`number_integer`

{% raw %}{{ product.metafields.psrestful.unspsc_commodity_code }}
→ 53102503{% endraw %}

Complete Metafield List

Key	Type	Description
`supplier_code`	text	PromoStandards supplier code
`product_id`	text	Product ID from PromoStandards
`extra_id`	integer	Extra ID from PSRESTful API
`brand`	text	Brand of the product
`line_name`	text	Line Name / Division
`effective_date`	datetime	Date product becomes available
`minimum_quantity`	integer	Minimum order quantity
`lead_time`	integer	Lead time in days
`is_on_demand`	boolean	Available on demand
`is_rush_service`	boolean	Rush service available
`export`	boolean	Product export status
`primary_material`	text	Primary material
`country_of_origin`	text	Country of origin
`features`	multi_line_text	Product features
`care_instructions`	multi_line_text	Care instructions
`location_decorations`	json	Decoration locations and methods
`imprint_size`	text	Imprint size
`default_set_up_charge`	text	Default setup charge
`default_run_charge`	text	Default run charge
`charge_type`	text	Charge type
`price_expires_date`	datetime	Price expiration date
`is_caution`	boolean	Has cautionary warnings
`caution_comment`	multi_line_text	Caution details
`is_hazmat`	boolean	Contains hazardous materials
`unspsc_commodity_code`	integer	UNSPSC commodity code

Metafields Overview Variant Metafields