Skip to main content

Understanding Product Properties & Custom Attributes in the 3Dsellers Catalog

This guide explains the difference between Product Properties and Custom Attributes, how they work together, and how they power your listings, mapping templates, rules, and synchronization across channels.

Written by Karolina Santiago
Updated yesterday

Overview

Inside the 3Dsellers Product Catalog, your product data is organized into two main structures:

  • Product Properties (built-in system fields)

  • Custom Attributes (flexible, user-defined fields)

Understanding the difference is essential for managing your catalog efficiently and publishing successfully to marketplaces.


What Are Product Properties?

Product Properties are predefined, built-in system fields that store your core product information.

They act as your master source of truth and are used across 3Dsellers for:

  • Channel Template Mapping

  • Rules & automation logic

  • Inventory management

  • Listing synchronization

  • Bulk editing & filtering


Example: Product Properties in the General Details Tab


The screenshot above shows the Product Properties section inside the General Details tab of a Catalog product.

This is where you manage the product’s core information — the structured data that powers mapping, rules, and listing synchronization.


What You’re Seeing in This Screen

Each field labeled “Product Property / …” represents a built-in system field.

In this example, the product includes:

  • SKU (Required) – The unique identifier for inventory tracking

  • Title (Required) – The main product name used across channels

  • Subtitle – Optional secondary title

  • Condition (Required) – Standardized condition (New, Used, etc.)

  • Condition Note – Additional condition details

  • Brand – Manufacturer or brand name

  • Manufacturer – Manufacturing company

  • Model Number – Model identifier

  • Warranty – Warranty information

  • SEO Keywords – Internal search/optimization keywords

  • Catalog Category (Required) – The internal 3Dsellers category assignment

  • Supplier – Optional supplier reference


Product Properties Structure (Organized by Sections)

Product Properties are organized into structured subsections inside the product editor — as shown below.


In the left navigation panel, you can see that properties are divided into the following areas:

  • Media

  • General Details

  • Identifiers

  • Pricing

  • Description

  • Size and Weight

  • Inventory

  • Internal Notes

  • Variations

  • Additional Channels

  • Custom Attributes

Each section groups related Product Properties to make product management clearer and more organized.

📘 For a detailed step-by-step explanation of each section and how to create/edit products, refer to this guide:


Key Characteristics of Product Properties

✔ System-defined and standardized
✔ Reusable across multiple channels
✔ Used directly in Mapping Templates
✔ Used in Rule logic
✔ Power linked listing updates


What Are Custom Attributes?

Custom Attributes are flexible fields that store additional product data.

They can be:

  1. Automatically created when importing listings from a sales channel

  2. Manually created by you to store additional data


🔄 Automatically Created Custom Attributes (Important)

When you import listings from a marketplace (eBay, Shopify, Amazon, etc.) into the Catalog:

  • 3Dsellers automatically creates Custom Attributes

  • These attributes store all marketplace-specific data such as:

    • Title variations

    • Item specifics

    • Description content

    • Channel-specific values

    • Fitment details

    • Additional structured fields

This ensures:
✔ No data is lost during import
✔ All listing information is preserved
✔ You can remap or reuse it later

These attributes often include the channel name (example:
topvid ebay MOTORS condition description).


✏ Manually Created Custom Attributes

You can also create Custom Attributes yourself to store business-specific data such as:

  • Warranty period

  • Supplier cost

  • Internal notes

  • Collection name

  • Material type

  • Seasonal tags

  • Internal classification codes

Custom Attributes give you flexibility beyond the system-defined Product Properties.

They can be created and managed in the Custom Attributes page.


Product Properties vs Custom Attributes

Aspect

Product Properties

Custom Attributes

Definition

Built-in system fields

User-created or auto-created fields

Flexibility

Fixed structure

Fully customizable

Purpose

Core product data

Supplementary or channel-specific data

Mapping

Common default mapping source

Requires manual mapping

Import Behavior

Always exist

Auto-created during channel import


Where Product Properties Are Used


1) Channel Template Mapping

Product Properties are the most common data source when mapping to marketplaces.


Example:

  • Product Property / Price → eBay Listing Price

  • Product Property / Product Title → Amazon Title

  • Product Property / Description → Shopify Description

You update once in the Catalog → it applies everywhere the property is mapped.

Example: Mapping Product Properties to Marketplace Fields


The screenshot above shows a Channel Template Mapping screen.

Each marketplace field (such as UPC, EAN, ISBN, MPN, ePID, and Images) is mapped to a corresponding Product Property in the Catalog.

For example:

  • Marketplace field Product Identifier (UPC) → mapped to Product Property / UPC

  • Marketplace field Picture Image 1 → mapped to Product Property / Image 1

This means that when publishing or revising a listing, 3Dsellers will pull the value directly from the selected Product Property in your Catalog.

If needed, you can also:

  • Add a Fallback value (used only if the main mapped property is empty)

  • Override with a Standalone value

This mapping structure ensures that your Catalog remains the central source of truth while allowing flexibility per channel.


2) Rules & Automation

Product Properties can be used in:


Rule Conditions

  • If Price > 100

  • If Category = Apparel

  • If Wholesale Price has value

Rule Outputs

  • Round up Price

  • Capitalize Title

  • Apply markup to Wholesale Price

📘 For a complete guide with practical use cases on how to build and use Rules in your Catalog, see:

👉 Catalog Channel Templates Rules: Complete Guide (with Practical Use Cases)


3) Linked Listing Synchronization

When a listing is linked to a Catalog product:

Changes in Product Properties can update the listing.

Examples:

  • Change Catalog Title → listing title updates

  • Change Catalog Price → listing price updates

  • Change Catalog Quantity → listing quantity updates

(Depending on mapping + sync settings.)

📘 For a deeper explanation of linked vs unlinked listings, and how synchronization works in the Catalog, see:


4) Catalog Management

You can:

  • Edit properties directly

  • Filter products by Brand / SKU / Category

  • Export products to CSV

  • Bulk edit properties

  • Re-import updates


How Custom Attributes Are Used

Custom Attributes are mainly used when:

  • You need channel-specific data

  • You imported listings from marketplaces

  • You need to map structured marketplace fields

  • You store internal business data

They become especially powerful in:

  • Channel Template Mapping

  • Rules (conditions based on channel-specific attributes)

  • Advanced listing logic


Mapping: Product Property vs Custom Attribute

When configuring a Channel Template Mapping, you can choose where the marketplace field should pull its data from.

You have three main options:

  • Product Property

  • Custom Attribute

  • Fallback value (optional backup)


Option 1: Mapping to a Product Property

If you map a marketplace field to a Product Property, 3Dsellers will pull the value directly from the standard Catalog field.


Example from the screenshot:

  • Marketplace field: Product Identifier (UPC)

  • Mapping: Product Property → UPC

  • Source value: Pulled from the UPC field inside the Product editor (Identifiers section)

📍 This means:

When publishing or revising the listing, the system takes the value stored under:

Edit Product → Identifiers → Product Property / UPC


This is the recommended approach for core data like:

  • Title

  • Price

  • SKU

  • UPC / EAN / MPN

  • Description

  • Quantity

Because Product Properties are your master catalog data and sync cleanly across channels.


Option 2: Mapping to a Custom Attribute

If you map to a Custom Attribute, the system will pull the value from that specific custom field instead of the standard Product Property.


Example from the screenshot:

  • Mapping: Custom Attribute → topvid ebay US upc

  • Source value: Pulled from:
    Edit Product → Custom Attributes → topvid ebay US upc


📍 This means:

If the Custom Attribute contains the value 2764827T487, that value will be sent to the marketplace — even if the main Product Property / UPC field contains something different.

This is useful when:

  • You imported listings from a channel and the data was saved as Custom Attributes

  • Different channels require different values

  • You want channel-specific overrides

  • You need to preserve original imported listing data


Option 3: Using a Fallback Value (Optional Backup)

You can also configure a Fallback value.

A fallback is used only if the main mapped source is empty.

Example logic:

  • Primary mapping: Product Property / UPC

  • Fallback: Custom Attribute / topvid ebay US upc

Result:

  • If Product Property / UPC has a value → use it

  • If it’s empty → automatically use the fallback value


Fallback helps prevent publishing errors caused by missing data.


How the System Decides What Value to Send

When publishing:

  1. Check the main mapped source (Product Property or Custom Attribute)

  2. If it has a value → send it

  3. If empty → check fallback (if configured)

  4. If both are empty → the field may fail validation on the marketplace


Best Practice

  • Use Product Properties for standardized core catalog data.

  • Use Custom Attributes for:

    • Imported channel data

    • Channel-specific values

    • Business-specific tracking fields

  • Use Fallbacks as a safety net — not as your primary data structure.


When to Use Product Properties vs Custom Attributes

Use Product Properties When:

  • Storing core product information

  • Data is required across most channels

  • You want automatic synchronization

  • You want reusable standardized fields


Use Custom Attributes When:

  • Data is channel-specific

  • You imported listings from marketplaces

  • You need structured marketplace item specifics

  • You want to store internal business data

  • You need extra flexibility


Best Practices

For Product Properties

✔ Keep Title, SKU, Price, Quantity updated
✔ Maintain consistent formatting
✔ Update the Catalog first before revising listings
✔ Use Rules instead of manual edits


For Custom Attributes

✔ Create only what you truly need
✔ Use clear naming conventions
✔ Map attributes intentionally
✔ Use fallback to prevent empty fields
✔ Periodically review unused attributes


Common Mistakes to Avoid

1) Overusing Custom Attributes

Too many attributes make your catalog harder to manage.


2) Inconsistent Data Entry

“Red” vs “red” vs “RED” causes mapping and filtering issues.

3) Not Mapping Custom Attributes

If not mapped, the data will never reach the channel.

4) Duplicating Data

Avoid storing the same value in both Product Properties and Custom Attributes unnecessarily.


Summary

Product Properties are your core structured data.
Custom Attributes are your flexible extension layer.

Together they allow you to:

  • Preserve imported marketplace data

  • Structure and standardize product information

  • Map intelligently to multiple channels

  • Build powerful rules

  • Keep linked listings synchronized

Understanding how and when to use each ensures a clean, scalable, and efficient product catalog.

Did this answer your question?