eBay item specifics: what they are and how to fill them in

What eBay item specifics are

Every eBay category has its own set of aspects. A laptop category might ask for processor and screen size, a clothing category for size and department, and most categories ask for brand. Each aspect has a name chosen by eBay and a value you supply, either picked from eBay’s list or typed as free text where the category allows it.

Item specifics sit alongside, not inside, your title and description. Buyers see them in a structured block on the listing page, and eBay’s search uses them for the filters in the left-hand column — brand, size, colour, condition, and so on. A detail that appears only in your description cannot be used by those filters.

Required, Required Soon, Recommended, and Additional

In Seller Hub’s listing flow, eBay groups a category’s item specifics into four tiers. The tier tells you what eBay enforces now, what it will enforce later, and what buyers are searching for.

How item specifics affect search, filters, and buyers

eBay is direct about filters: your item only appears in filtered search results if you have added the matching item specific. A buyer who filters a search by Brand or Size never sees a listing that left that field empty, however good its title is.

Item specifics also influence ranking. eBay’s Best Match factors include how complete the listing is and how closely it matches the buyer’s search terms. eBay’s seller guidance says item specifics increase your chances of being found on eBay, Google Shopping, and external search results, and the listing flow shows how often each specific was searched in the last 30 days — a useful way to decide which Recommended aspects to prioritise.

For buyers, item specifics answer the comparison questions before they read the description. Accurate values reduce “will this fit?” messages, and wrong values lead to returns: a buyer who filtered for a 45 cm width expects 45 cm.

Product identifiers: Brand, MPN, UPC, EAN, ISBN, and “Does not apply”

Product identifiers are a special group of item specifics. eBay describes them as unique codes created by the product manufacturer — GTINs such as UPC, EAN, and ISBN, plus the brand and manufacturer part number (MPN) — and says they are required in most categories.

When an identifier matches a product in eBay’s catalog, eBay suggests the match and can pre-fill the title, photos, and other details. Accept only exact matches: a different model year or pack size is a different product. In the Inventory API, eBay prefers an eBay product ID (ePID) for catalog matching, because one GTIN can map to more than one catalog product.

• Brand: the brand shown on the product, not the name of the company that sold it to you. For generic goods, eBay’s developer best-practice guidance suggests “Unbranded”.
• MPN: the manufacturer’s part or model number from the data sheet. Never put your own SKU here. Where a category requires an MPN, the Inventory API also requires a brand.
• UPC, EAN, or ISBN: the manufacturer’s GTIN for that exact variant. Validate the check digit before you use it.
• “Does not apply”: for items that genuinely have no identifier, such as antiques or custom goods, eBay lets you select “Does not apply”. The exact wording varies by eBay marketplace.

eBay item specifics character limits

Limits differ between eBay’s APIs, so check which one your listing tool uses. Where a source gives a number below, it is the documented maximum; individual categories can return their own maximum length for some aspects.

How to find a category’s required item specifics

There is no single eBay item specifics list: aspects and their tiers depend on the leaf category and the marketplace, and they change over time. Look them up for each category you sell in.

For a handful of listings, Seller Hub is enough: choose the category in the listing flow and it shows the Required, Required Soon, Recommended, and Additional specifics, with search counts and any Required Soon date. To fix existing listings in bulk, the Active Listings page lets you download an Excel file of listings missing specifics and upload it again, or select several listings and use “Add item specifics”.

For a large or changing catalog, use the Taxonomy API, which returns the same metadata in machine-readable form:

1. Identify the leaf category for the item. Aspects are defined per leaf category, not per parent category.
2. Get the category tree ID for the eBay marketplace you sell on.
3. Call GET /commerce/taxonomy/v1/category_tree/{category_tree_id}/get_item_aspects_for_category?category_id={id}. Both parameters are required.
4. Read aspectConstraint.aspectRequired to decide what is mandatory. Do not rely on aspectUsage: it returns RECOMMENDED for required aspects too.
5. Note aspectMode (SELECTION_ONLY means you must use one of eBay’s values) and itemToAspectCardinality (MULTI allows up to 30 values).
6. Store expectedRequiredByDate for Required Soon aspects so you can fill them before the deadline.
7. For many categories at once, call fetch_item_aspects on the category tree, which returns aspects for every leaf category, and refresh your copy regularly.

Reading the aspect metadata

Each aspect returned by getItemAspectsForCategory carries constraints that tell you how to fill it. These fields are where most mapping errors can be prevented.

Mapping supplier data sheet attributes to eBay aspects

If you resell other brands, most item specific values already exist in the supplier’s data sheet or spec sheet — just not in eBay’s words. Mapping is the work of turning a data sheet line into an aspect name and a value eBay accepts.

The examples below show the typical transformations. Aspect names vary by category, so confirm each one against the category’s metadata before you rely on the mapping.

Category examples: electronics, clothing, and toys

The aspects below are commonly requested in these categories and show where the values usually come from. They are illustrative only: the actual names and tiers depend on the leaf category and marketplace, so look them up as described above.

For clothing and footwear, eBay’s help pages describe a 2026 move to standardised size values, under which listings with missing or unclear sizes may be hidden. Check eBay’s current “Creating a listing” help before you rely on older size conventions.

Common item specifics mistakes

Most item specifics problems come from copying values without checking what eBay expects. These are the mistakes that most often cost visibility or cause returns.

• Filling only the Required aspects and ignoring Recommended ones that buyers filter on.
• Using aspectUsage instead of aspectRequired to decide what is mandatory when working with the API.
• Typing a free-text value into a SELECTION_ONLY aspect, or a spelling of a brand that does not match eBay’s list.
• Putting your SKU in MPN, or a reseller-bought barcode in UPC or EAN.
• Choosing “Does not apply” for an identifier the product actually has.
• Mixing units (45 cm on one listing, 450 mm on another) so that filters split the same value.
• Using the packaging dimensions where the aspect asks for the item’s dimensions.
• Repeating marketing phrases in aspect values instead of plain attribute values.
• Setting values once and never re-checking the category for new Required Soon aspects.

eBay item specifics checklist and preparing values at scale

Run through this list for each category before a batch of listings goes live. The slow part is usually gathering accurate values from supplier documents, not entering them.

Doc2Shelf helps with that first step. It reads supplier PDFs, extracts candidate attributes — scoring each extraction for confidence and keeping the source page and a short quote for each extracted fact — and prepares eBay-targeted draft copy and candidate item-specific values for your review. New eBay connections are coming soon; accounts already connected can keep publishing. New users export the reviewed copy as generic CSV or JSON, which is not an eBay import schema, and then enter the values in Seller Hub or their own listing tool.

• Leaf category confirmed for the marketplace you sell on.
• All Required aspects filled; Required Soon aspects filled ahead of their date.
• Recommended aspects with high search counts filled.
• Brand, MPN, and GTIN taken from the manufacturer’s documents and checked.
• Selection-only values normalised to eBay’s values.
• Units and formats consistent across listings.
• Values within the documented character limits.
• Catalog matches accepted only when they are the exact product.