SettingsProduct Import Settings

Product Import Settings

Configure how products are created in Shopify when importing from suppliers. These settings affect product titles, SKUs, variant organization, tags, and images.

Title Format

Available Formats

FormatExample
Product NameUnisex Jersey Tee
Product Name + Part IDUnisex Jersey Tee (3001)
Supplier + Product NameBella+Canvas Unisex Jersey Tee
Brand + Product NameBELLA+CANVAS Unisex Jersey Tee
Part ID + Product Name3001 - Unisex Jersey Tee
CustomUse placeholders

Custom Title Format

Use placeholders to create custom title formats:

PlaceholderDescriptionExample Value
{product_name}Product nameUnisex Jersey Tee
{part_id}Supplier part ID3001
{brand}Brand nameBELLA+CANVAS
{supplier}Supplier nameBella+Canvas
{category}Product categoryT-Shirts

Example custom format:

{brand} {product_name} - Style {part_id}
→ BELLA+CANVAS Unisex Jersey Tee - Style 3001

Setting Title Format

  1. Navigate to Settings > Product Import
  2. Select Title Format
  3. Choose a preset or enter a custom format
  4. Click Save

SKU Strategies

Available Strategies

PromoSync offers 7 SKU generation strategies:

StrategyFormatExample
part_idPart ID only3001
part_id_colorPart ID + Color3001-BLK
part_id_sizePart ID + Size3001-L
part_id_color_sizeFull variant ID3001-BLK-L
skuSupplier SKUBC3001BLK-L
upcUPC/Barcode882932789234
customCustom formatYOUR-3001-BLK-L

Custom SKU Format

Create custom SKU formats with placeholders:

PlaceholderDescription
{part_id}Supplier part ID
{color_code}Color abbreviation
{size_code}Size abbreviation
{upc}UPC barcode
{prefix}Your custom prefix

Example:

{prefix}-{part_id}-{color_code}-{size_code}
→ ABC-3001-BLK-L

SKU Configuration

  1. Go to Settings > Product Import
  2. Select SKU Strategy
  3. For custom, enter your format and prefix
  4. Click Save

Variant Grouping

Control how product variants are organized in Shopify.

Grouping Strategies

StrategyDescriptionUse Case
SingleAll variants in one productStandard setup
By ColorSeparate product per colorLarge variant counts
Split LimitSplit when exceeding limitPerformance optimization

Single Grouping

All variants appear as one product:

Product: Unisex Jersey Tee
├── Black / S
├── Black / M
├── Black / L
├── White / S
├── White / M
├── White / L
└── (etc.)

By Color Grouping

Creates separate products per color:

Product: Unisex Jersey Tee - Black
├── Black / S
├── Black / M
└── Black / L

Product: Unisex Jersey Tee - White
├── White / S
├── White / M
└── White / L

Split Limit Grouping

Splits products when variants exceed a threshold:

{
  "strategy": "split_limit",
  "limit": 100,
  "splitBy": "color"
}

Shopify’s variant limit is 100. Use this strategy for products with many combinations.

Tag Management

Automatic Tags

PromoSync can automatically add tags based on product attributes:

Tag TypeExample Tags
Suppliersupplier:sanmarr, supplier:alphabroder
Brandbrand:bella-canvas, brand:gildan
Categorycategory:t-shirts, category:polos
Color Familycolor:black, color:blue, color:red
Materialmaterial:cotton, material:polyester

Tag Configuration

  1. Go to Settings > Product Import
  2. Enable/disable each tag type
  3. Configure tag format (with or without prefix)
  4. Click Save
// Tag settings example
{
  "autoTags": {
    "supplier": true,
    "brand": true,
    "category": true,
    "color": false,
    "material": false
  },
  "tagFormat": "prefix",  // or "simple"
  "tagSeparator": ":"
}

Custom Tags

Add custom tags to all imported products:

promostandards, synced, {supplier}

Vendor Settings

Vendor Assignment

Choose how the Shopify vendor field is populated:

OptionValue Assigned
Supplier NameSanMar
Brand NameBELLA+CANVAS
Custom ValueYour Company
Leave Empty(blank)

Product Type Assignment

Set the Shopify product type:

OptionValue Assigned
CategoryT-Shirts
Supplier CategoryApparel > Tees
Custom ValuePromotional Apparel

Image Import Settings

Image Options

SettingDescription
Import ImagesEnable/disable image import
Primary ImageWhich image is set as featured
Image QualityStandard or high resolution
Max ImagesLimit images per product

Image Order

Configure the order of imported images:

{
  "imageOrder": [
    "primary",
    "front",
    "back",
    "detail",
    "lifestyle"
  ]
}

Image Alt Text

Automatically generate alt text:

{product_name} - {color} - View {position}
→ Unisex Jersey Tee - Black - View 1

Variant Options

Option Names

Customize variant option labels:

DefaultCustom
ColorGarment Color
SizeGarment Size
StyleProduct Style

Option Order

Set the order of variant options:

{
  "optionOrder": ["Color", "Size"],
  "colorFirst": true
}

Size Normalization

Normalize size values across suppliers:

Supplier ValueNormalized
SMS
MEDM
LGL
XLGXL
2XL2XL
2X2XL

Description Settings

Description Format

Choose what to include in product descriptions:

ContentInclude
Product Description
Features List
SpecificationsOptional
Size ChartOptional
Care InstructionsOptional

HTML Formatting

Enable rich HTML in descriptions:

<div class="product-description">
  <p>{{ description }}</p>
  <h3>Features</h3>
  <ul>
    {% for feature in features %}
    <li>{{ feature }}</li>
    {% endfor %}
  </ul>
</div>

Weight and Dimensions

Unit Settings

SettingOptions
Weight Unitlb, kg, oz, g
Dimension Unitin, cm

Default Values

Set defaults when supplier data is missing:

{
  "defaultWeight": 0.5,
  "defaultWeightUnit": "lb",
  "requireWeight": false
}

Import Preview

Before importing, preview how products will appear:

// Import preview
{
  "title": "BELLA+CANVAS Unisex Jersey Tee - Style 3001",
  "vendor": "Bella+Canvas",
  "productType": "T-Shirts",
  "tags": ["supplier:bella-canvas", "brand:bella-canvas", "category:t-shirts"],
  "variants": 45,
  "images": 8,
  "price": "$14.99",
  "sku": "3001-BLK-S"
}

Applying Settings to Existing Products

Settings apply to new imports by default. To update existing products:

  1. Select products in PromoSync
  2. Choose Bulk Actions > Reapply Import Settings
  3. Select which settings to reapply
  4. Confirm the operation

Best Practices

  1. Test with one product - Import a single product to verify settings
  2. Use consistent SKUs - Choose a strategy and stick with it
  3. Optimize for SEO - Include relevant keywords in titles
  4. Control variant count - Use grouping to manage large catalogs
  5. Tag strategically - Enable tags that help with collections and filtering