Add fitments to live eBay listings with FitX

FitX finds eBay listings you already have live with no vehicle compatibility, works out the vehicles, and pushes the list up to eBay.

FitX adds vehicle compatibility to eBay listings you already have live but which carry no compatibility data. It pulls in a copy of your eBay catalogue, finds the listings that qualify, works out each one's vehicles from its part number and brand, and pushes the finished list straight to the live listing.

FitX works on your existing eBay listings only. It does not touch parts you created in GridX Connect — those already have a Vehicle Compatibility card on the part, and that is where you review or tidy them.

It is also gated twice: FitX is company-admin only, and it needs a plan that includes it. Staff accounts and plans without it see the sidebar item locked.

> [!WARNING] > Processing uses your plan's SKU allowance. Every listing FitX successfully works out vehicles for counts against your plan exactly like adding a part does — it draws from the same pool, not a separate FitX budget. On Free and eBay Sponsored that allowance is a lifetime total that never resets, so a large run can use a meaningful share of it in one click. Check how many rows you have selected before you press Process.

> [!NOTE] > FitX is in the left sidebar under FitX. The page header reads "Fitment Optimizer" — both names refer to the same page.

Before you start

You must be a company admin. Staff accounts see "FitX is an admin-only feature".
Your plan must include FitX. On plans without it the sidebar item is greyed with a lock and a "Pro" badge.
Room in your plan allowance. Processing spends it per listing, the same as adding parts.
An eBay channel must be connected on the Channels page, and the first eBay sync must finish before Scan eBay unlocks.
Each listing you want processed needs a valid Part Number (MPN) and Brand on eBay. Listings missing either cannot be looked up.

Steps

Open FitX from the sidebar.
Wait for the first sync. FitX pulls a copy of your eBay catalogue on its own, showing "Syncing eBay Inventory" with a percent and "~{n} min left". On a large catalogue this takes a few minutes. When it finishes, the banner collapses to a green Synced pill.
Click Scan eBay. It is near-instant, because it reads the copy already pulled, and it fills the list with the listings that qualify.
Set your filter and search first, then tick the rows you want — changing either afterwards clears your selection.
Check your selection count against your remaining allowance. Processing charges per listing.
Click Process. GridX Connect works out each listing's vehicles from its part number and brand. A "Processing fitments — {done} / {total}" bar tracks the run.
Optionally, click the eye icon on a finished row to open Proposed Fitments and check or tidy the vehicles before they go up.
Tick the rows you want to publish and click Apply to eBay. Rows move to a green Pushed badge once the compatibility is live.

What processing costs

FitX is not billed separately. Each listing it successfully processes counts as one against your plan's SKU allowance, the same as adding a part through Add Part or Bulk Upload.

On Pro, Plus and Enterprise the allowance refreshes each billing cycle, and going past it is charged at your plan's per-listing rate.
On Free and eBay Sponsored the allowance is a lifetime total. It does not reset, so anything FitX uses is gone for good.

Because a scan can return thousands of rows, the safest habit is to process in batches rather than selecting everything at once. If you reach your limit part-way through a run, the remaining rows stay where they are and you can process them after you upgrade or your cycle rolls over. See plans, usage and spending limits.

Which listings qualify

A scan only returns listings FitX can actually work with. To be looked up, a listing needs a valid Part Number (MPN) and a Brand on eBay — those are what the vehicle match is built from.

Listings missing either come back as Ineligible. The row's info icon shows what is missing, so the first step is to add those details to the listing in eBay Seller Hub. If an item you have corrected does not reappear in a later scan, contact support with the eBay item number and we will pick it up.

A listing can also have perfectly good details and still find nothing. That comes back as Skipped, which means no compatibility data could be found for that part number. There is nothing to fix on the listing itself, and Skipped rows cannot be put through Process again — the button only accepts rows that are Pending, Queued or Failed. If you believe a Skipped part does have known vehicle compatibility, contact support with the part number.

Use Refresh on the sync banner any time you change listings on eBay. FitX works from its copy of your catalogue, so changes made in Seller Hub are not visible until you re-pull.

Selecting listings without losing your selection

The list is flat, 50 rows to a page, with one filter dropdown and a search box above it. The dropdown offers All items, Pending, Ready, Pushed, No fitments and Failed, each with a live count.

Tick rows individually, or use the header checkbox to take the whole page. When a full page is ticked, a banner offers Select all {total} items, capped at 5,000. Past that you get "Selection limited" with a partial pick, and you work through the rest in a second batch.

> [!TIP] > Changing the filter or typing in the search box clears your selection. It is deliberate — an action should never run on rows you can no longer see — so set your filter and search first, and tick your rows last.

Processing and applying both run in the background. The progress bar is safe to refresh, and you can leave the page and come back later without losing the run.

Statuses and what to do about them

| Status | What it means | What to do | |---|---|---| | Pending | Scanned and qualifies, but the vehicles have not been worked out yet. | Tick it and press Process. This spends your allowance. | | Queued / Processing | Accepted into a run, or being worked out now. | Wait — the progress bar tracks it. | | Ready | Processed, at least one vehicle proposed, not yet pushed. This is the applyable state. | Preview if you want to, then Apply to eBay. Applying costs nothing further. | | Pushing… | Being sent to the eBay listing. | Wait. | | Pushed (green) | The compatibility is live on the eBay listing. | Nothing. Use View on eBay to confirm. Editing is locked from here. | | Push failed | The vehicles were worked out, but eBay rejected the push. | Tick the item and press Apply to eBay again. This does not spend allowance again. | | Ineligible | The listing is missing its Part Number (MPN) or Brand / Vehicle Make. | Add the missing details in eBay Seller Hub. If the item does not come back in a later scan, contact support. | | Skipped | The listing's fields were fine, but no compatibility could be found. | Nothing to fix on the listing. Skipped rows cannot be processed again — contact support if you think it is wrong. | | Failed | Something went wrong working the vehicles out. | Switch the filter to Failed, tick the rows and press Retry. |

On the Failed filter the Process button relabels itself as Retry — it is the same action, and it spends allowance the same way. Note that Push failed has no bucket of its own in the filter dropdown, so push failures cannot be listed that way.

Previewing and editing before you apply

Click the eye icon in the Actions column of any processed row to open Proposed Fitments. It shows the item card, a "{n} vehicle compatibilities" count, and the full vehicle table. The icon appears only on rows that have finished processing.

Inside the preview, click Edit to remove rows you do not agree with and add notes. Notes here are capped at 800 characters, which is more than the 500 you get on a part's own fitments. Save Changes keeps your edits; Cancel drops them with no prompt.

Previewing is optional. Apply to eBay *is* the sign-off — there is no separate approve or reject step, so any item sitting at Ready goes straight up when you apply it. If you want to check the proposed vehicles first, do it before you apply, not after.

Once an item shows the green Pushed badge it becomes read-only and the Edit button disappears. Use View on eBay to check what landed, and make any further changes to that listing in eBay Seller Hub.

If something goes wrong

| On-screen text | Why it appears | Fix | |---|---|---| | "No eBay channel connected" / "Connect an eBay channel in Settings before scanning." | FitX needs your eBay account connected. | Connect eBay on the Channels page, then return to FitX — the connection lives there, even though the message says Settings. | | "Starting inventory sync…" / "Connecting to your eBay account. This may take a few minutes." | FitX is pulling in a copy of your eBay catalogue for the first time. | Wait — Scan eBay unlocks when the banner turns green (Synced). | | "Sync failed" | The copy of your eBay catalogue could not be pulled in. | Click Retry on the sync banner. If it keeps failing, check your eBay connection in Channels. | | "No fitments found for this item" | The listing was processed but no compatible vehicles could be found. | Nothing to fix on the listing — it shows as Skipped and cannot be processed again. | | "How to fix:" (on an Ineligible row) | The listing is missing its Part Number (MPN) or Brand / Vehicle Make. | Add the missing details in eBay Seller Hub. If the corrected item does not return in a later scan, contact support with the eBay item number. | | "Selection limited" / "Showing {returned} of {total} items (maximum 5,000)." | You tried to select more than 5,000 listings. | Work through them in batches of 5,000. | | "Processing complete" — "{success} succeeded, {issues} skipped or failed" | A Process run finished. | Review the problem rows on the No fitments and Failed filters. | | "Apply complete" — "{success} pushed, {failed} failed" | An Apply run finished. | Re-apply anything that failed. | | "FitX is an admin-only feature" | You are not a company admin. | Ask a company admin to run FitX. | | "FitX requires a paid plan." / "FitX is not available on your current plan" | FitX is not on your plan. | Upgrade your plan. | | A message about your SKU limit or spending limit during a run | Processing spends your plan allowance, and you reached it mid-run. | Raise your spending limit or upgrade, then process the remaining rows. |

Scan eBay is greyed out. The first copy of your eBay catalogue is still being pulled in. Wait for the banner to turn into a green Synced pill.

My selection disappeared. Changing the filter or typing in the search box clears it. Set both first, then tick your rows.

A run stopped part-way with a message about eBay's daily budget. eBay's own daily allowance was reached mid-run. Those listings are not lost — they stay Pending or remain applyable, and you can retry them once the allowance resets.

A run stopped part-way and my allowance is used up. Processing charges per listing against your plan. The rows that did not process are unchanged and can be processed later once you have room. See plans, usage and spending limits.

Lots of rows failed at once. Switch the filter to Failed, tick them and press Retry. If they keep failing, check the info icon on a row for the reason, or use Download CSV on the amber issues banner to export the full problem breakdown from your most recent scan.