Skip to content
Convermax Docs

Fitment Editor Commands

The bulk editor lets you change fitment data for many products at once using a short command. You pick the products, type a command, and click Apply.

A command is written in YAML, an indentation-based text format.

The format

Section titled “The format”

A command is made of:

  • The action — what to do: Add, Remove, or Update.
  • The fitment list — the vehicles it applies to, each starting with a dash (-).

The indentation matters: keep it the way the examples show, with the fields of one fitment lined up under each other.

The field names are the same as in your store’s fitment data: Year, Make, Model, Submodel, etc.

The actions

Section titled “The actions”

Add

Section titled “Add”
Add:
  - Make: Ford
    Model: F-150
    Year: 2024

Remove

Section titled “Remove”
Remove:
  - Make: Ford
    Model: F-150
    Year: 2024

Update

Section titled “Update”
Find:
  - Make: Ford
    Model: F-150
    Submodel: Base
Update:
  - Submodel: XL

Always used with a Find, explained below.

Two ways to write a command

Section titled “Two ways to write a command”

On fitments you type in

Section titled “On fitments you type in”

You list the fitments directly, and the action uses exactly what you wrote.

For example, add a 2024 F-150:

Add:
  - Make: Ford
    Model: F-150
    Year: 2024

On existing fitments you match

Section titled “On existing fitments you match”

You add a Find that picks existing fitments, and the action reuses their values — you only write the fields you want to override, and the rest are taken from the matched fitment. This mode lets you adjust many products’ fitments based on what they already have.

For example, find every product that already fits a 2025 F-150, and also make it fit 2026:

Find:
  - Make: Ford
    Model: F-150
    Year: 2025
Add:
  - Year: 2026

If Find matches nothing on a product, that product is left untouched.

Add and Remove work both ways. Update always uses a Find.

How matching works

Section titled “How matching works”

When you match existing fitments, a few rules decide which ones get picked:

  • More fields means a narrower match. Only the fields you write are checked; any field you leave out can hold any value. So Make: Ford matches every Ford, while adding Model and Year narrows it down.
  • An empty value matches an empty field. Write Submodel: "" to match only fitments whose Submodel is blank — different from leaving Submodel out, which matches any Submodel.

Years

Section titled “Years”

The Year field accepts several forms:

You writeIt means
2018a single year
2010-2020a range of years
84the year 1984 (two-digit shorthand)
2018+from 2018 up to the current year
2010-presentup to the current year (present, current, and up all work)
1995, 1997, 2000-2005several years and ranges at once, separated by commas

Use cases

Section titled “Use cases”

Add

Section titled “Add”

Add several fitments at once, listing as many as you need:

Add:
  - Make: Audi
    Model: A4
    Year: 2020-2023
    Submodel: Premium
  - Make: Ford
    Model: F-150
    Year: 2021-2022, 2024

If an F-250 fitment has 2025 among its years, add an F-350 covering all those years, inheriting the F-250’s other fields:

Find:
  - Make: Ford
    Model: F-250
    Year: 2025
Add:
  - Model: F-350

Extend F-150 fitments that reach 2025 to also cover 2026:

Find:
  - Make: Ford
    Model: F-150
    Year: 2025
Add:
  - Year: 2026

Remove

Section titled “Remove”

Remove every F-150, regardless of year or any other fields:

Remove:
  - Make: Ford
    Model: F-150

Remove only the 2010–2015 F-150:

Remove:
  - Make: Ford
    Model: F-150
    Year: 2010-2015

Remove 2025, but only from products that also have 2024:

Find:
  - Make: Ford
    Model: F-150
    Year: 2024
Remove:
  - Year: 2025

A product fitting a 2023–2026 F-150 (it includes 2024) becomes 2023–2024, 2026 after 2025 is removed. A product fitting a 2025–2026 F-150 (no 2024) is left alone.

Update

Section titled “Update”

Fix a misspelled Model:

Find:
  - Make: Ford
    Model: F150
Update:
  - Model: F-150

Replace the year range on the matched F-250:

Find:
  - Make: Ford
    Model: F-250
    Year: 2010-2020
Update:
  - Year: 2015-2018

A 2010–2020 F-250 becomes a 2015–2018 F-250.

If only part of the range matches, only that part is replaced. For a 2018–2025 F-250, only 2018–2020 matches (the overlap with 2010-2020). That part is replaced with 2015–2018, and 2021–2025 stays — giving 2015–2018, 2021–2025.

Fill in an empty Submodel:

Find:
  - Make: Ford
    Model: F-150
    Submodel: ''
Update:
  - Submodel: Base

Set notes on the 2015–2020 F-150:

Find:
  - Make: Ford
    Model: F-150
    Year: 2015-2020
Update:
  - Notes: Check bolt pattern before ordering.