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 do not see FitX in the sidebar at all. Admins on a plan 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 is one list. The filter, the search box and Scan eBay sit above it, and a status bar sits below it.
Before you start
- You must be a company admin. Staff accounts see "FitX is an admin-only feature".
- Your plan must include FitX. The pricing page lists it on eBay Sponsored, Pro, Plus and Enterprise (FitX Elite on Plus and Enterprise), and not on Free. 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 a Brand or Vehicle Make 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. The status bar under the list shows "Syncing eBay inventory" with a percent and, when it can tell, "~{n} min left". On a large catalogue this takes a few minutes. When it finishes, the bar shows a green dot and Synced.
- Click Scan eBay, above the list. 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.
- Ticking a row turns the bar under the list blue and shows Process and Apply to eBay. Click Process. GridX Connect works out each listing's vehicles from its part number and brand. You see "Queued {n} items for processing", and the run shows in the activity bar at the top of the app as "FitX Process: {n} items".
- 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 or Vehicle Make 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. FitX works from its own copy of your catalogue, so it cannot see the fix until you refresh that copy: clear any ticked rows, press the Refresh sync icon at the right end of the status bar, wait for Synced, then click Scan eBay again. 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.
Press the Refresh sync icon (two curved arrows, at the right end of the status bar) any time you change listings on eBay, then click Scan eBay again. FitX works from its copy of your catalogue, so changes made in Seller Hub are not visible until you re-pull. The icon shows only when the bar reads Synced and no rows are ticked.
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. The page arrows are in the status bar under the list.
Tick rows individually, or use the header checkbox to take the whole page. As soon as a row is ticked, the bar under the list turns blue and shows Clear, the number selected, and Select all {total}, which takes every listing in the current filter, capped at 5,000. Past that you get "Selection limited" with a partial pick, and you work through the rest in a second batch.
While rows are ticked the page arrows are hidden, so you cannot tick rows on one page and then add more from another. Use Select all {total} for that. Clicking the header checkbox while anything is ticked clears the whole selection.
> [!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 keep running in the background, so a run carries on if you refresh, leave the page or close the tab. Progress shows in the activity bar at the top of the app. After a full page refresh the progress display does not come back, but the run continues and the rows show the result when it finishes.
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 activity bar at the top of the app 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, refresh the sync, then scan again. 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.
When there are problem rows, the status bar shows No fitments and Failed chips with their counts. Click a chip to filter to those rows. Click it again to go back to all items.
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. At least one vehicle has to stay, so the last row cannot be removed. 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. The preview has its own Apply to eBay button, which sends that one listing. It also works for a Push failed row.
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 Channels before scanning." | FitX needs your eBay account connected. | Connect eBay on the Channels page, then return to FitX. | | "Starting inventory sync" / "Connecting to your eBay account. This can take a few minutes." | FitX is pulling in a copy of your eBay catalogue for the first time. | Wait. Scan eBay unlocks when the status bar shows Synced. If the bar stays on this message, or on "Waiting for the inventory sync", check that an eBay channel is connected on the Channels page. | | "Sync failed" | The copy of your eBay catalogue could not be pulled in. | Click Retry in the status bar. 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, press the Refresh sync icon in the status bar, then click Scan eBay again. 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. | | "Processing complete (some items deferred)" | Some listings hit eBay's daily budget and stayed Pending. | Process them again after the next daily reset. | | "Apply complete" — "{success} pushed, {failed} failed" | An Apply run finished. | Re-apply anything that failed. | | "Apply hit the daily eBay budget" | eBay's daily budget was reached part-way. The remaining listings stay applyable. | Apply them again after the next daily reset. | | "Apply paused by eBay rate limit" | eBay slowed the run down. The listings that were not pushed stay applyable. | Apply them again shortly. | | "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 status bar to show Synced. If it shows "Sync failed" instead, click Retry.
My selection disappeared. Changing the filter or typing in the search box clears it. Set both first, then tick your rows. The selection also clears when a Process or Apply run starts, and when you click the header checkbox while rows are ticked.
A run finished with a message about eBay's daily budget or rate limit. eBay's own daily allowance was reached mid-run, or eBay slowed the run down. Those listings are not lost. They stay Pending or remain applyable, and you can run them again 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 the download icon in the status bar (Download issues CSV) to export the full problem breakdown from your most recent scan. The icon shows when there are No fitments or Failed rows and nothing is ticked.