About Custom Fitment Data Sources

Fitments stored on the product

You can store fitment data directly on your products in two ways:

• Product tags — fitments in the fits_Years`Make`Model`Submodel tag format, fits_Universal for universal products, and convermax-skip to hide a product from search. See Add Custom Fitment Data with Tags.
• Product metafields — fitments entered as a YAML list in the convermax.fitment metafield, which can also mark a product Universal or Non-Vehicle Product. See Add Custom Fitment Data with Metafields.

Fitments stored separately

Formats

Spreadsheets

The custom fitment data file must have the following format:

To mark a product as universal, insert “Yes” in the “Universal” column.

File Format Supported: Google Spreadsheets, CSV/Excel files, or ZIP archives containing CSV/Excel files.

This is an example of a custom fitment file: https://docs.google.com/spreadsheets/d/1gc4zYP8P2GISsDhAwtzudWljYwPLesWDxBX-oALhQQ0

Note

If you need any additional data columns or require some special data processing, please contact us at [email protected].

ACES

We support loading fitments from ACES files exported manually. It can be a folder with ACES .xml or zip with ACES .xml inside. A part applies to a product whose SKU is {BrandID}_{PartNumber}, or whose SKU is the part number and whose vendor is the part’s AAIA brand. Review shows the parts that match no product. If you have another format, contact us for ACES fitment parsing tuning.

Tip

Despite the support for loading manually exported ACES, we strongly recommend properly configuring connection with their source via Fitment Data Integrations to provide always-up-to-date information and minimize unnecessary customizations.

Storages

On the Custom Fitment Data card, under Where are your fitment files?, choose one of these options:

• In my Google Drive or on my server: enter the Folder link (see the sources below) and click Check access to list the files Convermax finds there. Then click Review files to review them on the import page, which opens in a new tab. The folder is connected only when you click Connect folder there.
• I don’t have a place for them: choose where Convermax keeps the files, Shopify Files (Content > Files in your Shopify admin, up to 20 MB per file) or Google Drive, and save. Then click Upload a file on the card to add files on the import page, which reviews each file before saving it.

You can connect folders with custom fitment data files from the following sources:

Google Drive

You can connect a Google Drive folder containing Google Spreadsheets, CSV/Excel files, or ZIP archives containing CSV/Excel files using the Convermax Shopify app.

1. Open the Convermax app from your Shopify admin panel.
2. Go to the Integrations page.
3. Click the Custom Fitment Data card and choose In my Google Drive or on my server.
4. Enter the Google Drive folder URL.

Note

For this source, you don’t need to fill out the login/password inputs, but we need you to share this folder with our accounts.

To share your folder with Convermax, do the following:

1. Select your folder and click “Share”.

2. Share the folder with these accounts:
   • [email protected]
   • [email protected]

FTP/SFTP Servers

You can connect an FTP/SFTP folder containing CSV/Excel files, or ZIP archives using the Convermax Shopify app.

1. Open the Convermax app from your Shopify admin panel.
2. Go to the Integrations page.
3. Click the Custom Fitment Data card and choose In my Google Drive or on my server.
4. Enter the folder URL including the scheme (ftp:// or sftp:// respectively).
5. Enter the login/password required to access your server.

Amazon S3

You can connect an Amazon S3 folder containing CSV/Excel files, or ZIP archives using the Convermax Shopify app.

1. Open the Convermax app from your Shopify admin panel.
2. Go to the Integrations page.
3. Click the Custom Fitment Data card and choose In my Google Drive or on my server.
4. Enter the folder URL using the following format:

s3://<bucket-name>/<folder>/

• <bucket name> - S3 bucket
• <folder> - optional folder

5. Enter the access key ID as the login and the secret access key as the password.