This App is a handy tool to Search Products very quickly from large products database.
C: Year Make Model Search allows your customers to find products on your website by Year, Make, Model or any additional fields you have created with the help of this App.
Thank you for purchasing C: Year Make Model Search Shopify App. If you have any difficulty with this App or you find an issue, please feel free to send us a message: supportshpfy@capacitywebsolutions.com
Below you will find the detailed documentation on how to use our App and we wish you have a great experience with our Shopify App.
Pricing Details
Trial Days: 7 Days
Plans:
i. Development Plan (Free $0)[For Affiliate/ Development Stores & Partner Test Stores]
ii. Basic Plan ($10 per month)
iii. Pro Plan ($50 per month)
iv. Premium Plan ($75 per month)
You can check more for feature details for each plan by (click here)
How does YMM Searchbox look?
Horizontal Style:
Vertical Style:
User Friendly YMM Dropdowns:
This feature will provide ease to your customers by allowing them to choose one of the dropdown values, and the next in the chain will be opened automatically. Customers can also search inside the YMM dropdown values.
For Online Store 2.0 Theme: You can watch video tutorial for App Configuration Steps by (click here)
For Vintage Theme: You can watch video tutorial for App Configuration Steps by (click here)
Step-1: Choose your theme first, then click on the "Customize" button, then go to the theme customizer section and Enable "App Embeds" for the YMM app, just like in the screenshot below.
Step-2: To Display "YMM Searchbox" on the website, you can use either of the techniques below.
***NOTE: "App Block" is available only in the "Online Store 2.0" theme, so you can use Technique-1 for the "Online Store 2.0" theme, but if your theme does not support App Block functionality, you can add a ymm searchbox with the App Shortcode, i.e., Technique 2.
Technique-1 (Via App Block)
You can display YMM searchbox on online store via "App Block" just by follow below screenshot then click on "Save" button at top right corner! You can drag and drop apps section at any spot and add our App block, where you want to display YMMBox on your website.
Technique-2 (Via App Shortcode)
Where do I use the above shortcode?
i. Inside Page Description: You can only show the YMM Searchbox on specified pages this way.
ii. Inside Custom Liquid Section/Block of a Theme:
iii. Inside Theme Template File: You can paste shortcode inside the theme.liquid file after the header section to display YMMBox site-wide, or display YMMBox only on product pages, like below.
Step-3 (Optional) [PRO Plan Feature]: To display "YMM Compatibility Table" on the "Product details page" of website, you can use either of the techniques below.
Technique-1 (Via App Block)
First go to your theme customizer section, then click on Products → Default Product page from the top dropdown, and you`ll see the "YMM Compatiblity Chart" app block just like in the below screenshot. You can add this app block wherever you want to show the table and click on the "Save" button at the top right corner!
Technique-2 (Via App Shortcode)
Where do I use the above shortcode?
i. Inside Theme's Product Template File:
ii. Inside Custom Liquid Section/Block of a Theme:
***IMPORTANT NOTE: First, please take a backup of your theme in which YMM app is present and proceed with the steps below for any theme in which you want to do YMM app customizations. By follow below listed steps for "Disable theme app extension", you can add/edit contents in our YMM app files in your theme means you can customize our App by your own way or if you'll need any customizations help from our side then you can drop an email at >> supportshpfy@capacitywebsolutions.com
Go to Admin → Apps → C: Year Make Model Search → How to Use it → Disable Theme App Extension (FOR DEVELOPERS) → Click on Full Screen Mode. Then you can follow steps listed there one by one.
Customizing App JavaScript (For Developers)
Frequently asked questions:
Q1: Which JavaScript file should developers edit to customize the app?
The app provides two versions of the same script:
ymm-searchbox-new-version.js: Written in modern JavaScript (ES6) and recommended for development and customization.
ymm-searchbox-new-version.min.js: ES5-compatible build, intended for older browser support and production use.
Q2: How should developers make custom changes?
Make all custom changes in ymm-searchbox-new-version.js(ES6 source file).
NOTE: If ES5 support is required, compile the updated ES6 file using a build tool such as Babel or Vite. Replace or regenerate the ES5 output as ymm-searchbox-new-version.min.js.
Q3: Can developers directly edit the ES5 (.min.js) file?
Directly editing ymm-searchbox-new-version.min.js is not recommended, as it is a compiled file and harder to maintain. Always update the ES6 source file i.e. ymm-searchbox-new-version.js and recompile for ES5 compatibility.
Q4: Why are two JavaScript files provided?
Clean and maintainable modern ES6 code for customization
Backward compatibility for older browsers requiring ES5
Safe customization without breaking the app extension
Quick Shortcodes [GUIDE]
1. To Display YMM Searchbox
Where do I use the above shortcode?
i. Inside Page Description: You can only show the YMM Searchbox on specified pages this way.
ii. Inside Custom Liquid Section/Block of a Theme:
iii. Inside Theme Template File: You can paste shortcode inside the theme.liquid file after the header section to display YMMBox site-wide, or display YMMBox only on product pages, like below.
2. To Display YMM Compatible Table [PRO Plan Feature]
Where do I use the above shortcode?
i. Inside Theme's Product Template File:
ii. Inside Custom Liquid Section/Block of a Theme:
3. To display YMM-searched information inside the admin's new order email receipt [Pro Plan Feature]
If you (the admin) want to display selected YMM information inside your own admin's New Order email receipt then you can do so by pasting the below code into your Admin's New Order Email Notification Template.
See the result of the above shortcode working in the screenshot below to get an exact idea.
4. To display YMM-searched information inside the customer's order confirmation email receipt [Pro Plan Feature]
If you (the admin) want to display selected YMM information inside the customer's Order Confirmation email receipt then you can do so by pasting the below code into your Customer Order Confirmation Email Notification Template.
See the result of the above shortcode working in the screenshot below to get an exact idea.
NOTE: If you`re not sure for any of above quick shortcodes and want to use that feature then no worries you can simply drop an email at →supportshpfy@capacitywebsolutions.com. For displaying the YMM searched information inside email notification templates, please provide admin login details with themes, apps, products, orders, and settings section access to us.
5. To display "My Garage Box" as a "dropdown menu" in website's header [Pro Plan Feature]
If you (the admin) want to display "My Garage Box" as a dropdown menu sitewide, then you'll need to paste the shortcode below inside the header file of your theme.
Where do I need to paste the above shortcode?
!Important Note:Every theme has different files & structure, so the filename will vary based upon the theme. If you aren't sure then no worries, please drop us an email at supportshpfy@capacitywebsolutions.com, and we'll be able to help you to set it out.
See the result of the above shortcode working in the screenshot below to get an exact idea.
6. To display "My Garage Box" as a "Modal Pop-up" in website [Pro Plan Feature]
Through the use of the below shortcode, My Garage box will be showing up as a modal pop-up once clicking on the My Garage icon that is sticky to the website, either left or right.
Where do I need to paste the above shortcode?
See the result of the above shortcode working in the screenshots below to get an exact idea.
My Garage Sticky Icon Orientation: Left or Right
By clicking on My Garage sticky icon, my garage contents will be displayed inside a modal pop-up.
App Uninstallation Steps
After App Uninstalled by Store Owner, Shopify does not permit us to access files on your store. So, You have to remove App code files manually from your Active Theme or Any Theme in which You had previously installed YMM App Files.
NOTE: If you`ve disabled the theme app extension to customize our YMM app files in your theme, then only you`ll need to remove those files; otherwise, our YMM app injects 0 files in your theme. So, you can skip below step-1. Or if you`ve created ymm-searchbox.liquid or ymm-compatible-list.liquid (This file exists in a Pro/Premium plan only) file as a "Quick Tip" to re-setup ymm searchbox or ymm compatible table during App Upgradations Process Or if you`ve created page.ymm-custom.liquid file to resolve grid/design issues for the YMM result page in your theme then only you`ll need to remove it by follow below listed step-1.
Step-1 (Optional) : From your Shopify admin, click on Online Store → Themes and Select your Theme in which YMM app is installed and Delete files one by one by follow below screenshot.
First please search "ymm" in search bar. Then you`ll see YMM app files. Please delete YMM app file one by one.
NOTE: Some of the features are for Pro/Premium plan users only, so if you don't find some of the files, for instance, ymm-my-garage.js, then no worries; it's not needed for you to delete.
Step-2 *: From your Shopify admin, click on Online Store >> Pages and Delete "Product Result" Page.
Step-3 * [For Pro/Premium Plan Users]: From your Shopify admin, click on Online Store >> Pages and Delete "My Garage" Page if you've used "My Garage" feature & created "My Garage" Page then and only.
NOTE: If you (Admin) have used My Garage →"Save My Bike" feature, then there is one definition created for customers custom data that is holding/saving YMM histories made by your customers in their customer accounts that you can delete it by go to Shopify admin → Settings → Custom data then follow below listed screenshot.
Step-4 *: From your Shopify admin, click on Apps then click on "Uninstall" link in front of our YMM app by follow below screenshot.
Manage YMM
Go to Admin → Apps → C: Year Make Model Search → Manage YMM
From Here, You can Manage YMM data by Edit / Delete / Search operations.
[NEW FEATURE] Also, you can sort YMM records such as: Newest Records First or Oldest Records First or Alphabetically A to Z or Alphabetically Z to A.
Manage Fields
Go to Admin → Apps → C: Year Make Model Search → Manage Fields
From here, You can Manage Multiple Dropdowns as per your requirement. Watch Video Guide (click here)
Add YMM
Go to Admin → Apps → C: Year Make Model Search → Add YMM
From Here, You can ADD YMM values easily by Auto Suggestion feature, which suggest you about previous YMM values while adding a new record.
Also, You can Assign selected products to YMM record easily just follow the steps listed in below window:
"Enable Year Range" (New Feature)
From "ADD YMM" section, now you can add year ranges such as: 2019-2021 too. By mistake, if you've entered the same year again, like: 2019-2019, then it will just add a single row with the year, such as: 2019.
Bulk Product Assign
Go to Admin → Apps → C: Year Make Model Search → Bulk Product Assign
From Here, You can Bulk Assign Products quickly to Multiple YMM Rows.
For Bulk Assign, Just follow the steps mentioned in below window:
2. Whenever you Change/Add Fields. Please "Download Sample CSV" File to get latest fields and Ordering.
3. You can refer Store Product Ids by Click on Export Product CSV Button.
4. You must have to keep "Product Ids" as "First Column" in your CSV and Enter Product Ids as "~" (tilde sign) separated like snapshot.
IMPORTANT! You must have to Enter "Product Id" in your YMM CSV not "Product SKU"
Please follow below steps for Assigning Product Ids in YMM Rows by CSV:
Step-1: Export All Product Ids CSV by Click on Export Product CSV Button.
Step-2: Now Next step is to Assign Product IDs to YMM rows in CSV file. It is simple process.Just open your Exported Products CSV file which is generated in Step-1 and Find your product name or product SKU then you will see Product ID in First column of it like below snapshot:
Now just add it in YMM CSV file like below snapshot:
Step-3: After Prepared Final YMM CSV with assigned Product Ids then Import your YMM CSV.
Answer: It will allow you to import same Row for each year of range value means You do not have to add 10 YMM Rows in CSV for the year value which starts from 2001 to 2010, instead of it you just need to write one YMM row in which you have to put range value in your Year column like: 2001-2010.
Please follow below steps for Import Year Range Data:
Step-1: Download sample CSV just by click on button to get your Fields ordering.
Step-2: Then modify with your YMM range values.
Step-3: Save it!
Step-4: Select Enable Year Ranges option and Choose your Range Field which have "Year Range Data" for e.x: If Field name is: "My Year" then choose it from Dropdown.
Step-5: Then after Click on Upload button.
Year Range Feature CSV Template:
Note About Year Range Feature:
1. If you specify Year Range then it must be Numeric value only and it must be in four digit format YYYY otherwise it will be skipped.
2. If you have entered range value like 2002-2005 & Choose Wrong Range Field from Dropdown then it will add one YMM Row only with field value as "2002-2005" , not three rows for the years - 2002 to 2005.
Import Rows Option
You can Import YMM Rows either with Bulk Insert / Append Rows / Update Rows option.
All Previous Records will be deleted by Bulk Insert option. So, please be careful & take Backup by Export YMM Records CSV first.
Step-1: Download sample csv file for Adding New Rows.
Step-2: Then Modify CSV for your New YMM values.
Step-3: To Assign Products to YMM Rows by CSV then just click on Export Products CSV button.
Step-4: Refer Product Id from exported products csv in your YMM rows just enter "~" tilde sign between Product Id if its multiple
Step-5: Save it & Upload your modified CSV just by:
- Choose your modified CSV file.
- Choose Bulk Insert option.
- If you have enter year ranges like: 2002-2005 then only you have to select "Enable Year range values" checkbox and choose your field that contains year range value from dropdown.
Step-1: Download current Rows CSV from Export CSV section.
Step-2:Choose CSV Template as Bulk Insert/Append Rows from dropdown.
Step-3: Click on Export YMM CSV button then open your downloaded CSV.
Step-4: You can Add new Rows within this CSV.
Step-5: Upload your modified CSV just by:
- Choose your modified CSV file
- Choose Append Rows option
- If you have enter year ranges like: 2002-2005 then only you have to select "Enable Year range values" checkbox and choose your field that contains year range value from dropdown.
Step-2: Filter ymm records as per your need which you want to delete in bulk.
Step-3:Download YMM CSV file by choose option such as: "With Id Column" then click on the 'Download YMM CSV' button (This will generate csv file for your filtered ymm records).
Step-4: Go to Import/Export tab.
Step-5: Choose that downloaded ymm csv file to delete those ymm records of csv file in bulk.
Step-6: Choose import method such as: 'Delete Rows'.
Step-7: Click on the Upload File button.
Delete Rows CSV Format:
Warning! Please do not modify "Id" column value and also keep this column as it is.
Export YMM CSV
You can Export YMM Rows by choose CSV Template option such as either Bulk Insert/Append Rows OR Update Rows then after Click on Export YMM CSV button.
How to fix errors while Import YMM CSV into my Language?
This is caused by improper CSV format.Please use openoffice.org calc spreadsheet application and saving in UTF-8 format. OR Please use Google Doc for Convert Your CSV in UTF-8 format.
Please refer below section for more details on How to convert CSV file in UTF-8 format.
How to convert CSV file in UTF-8 format?
For Convert your file in UTF-8 please follow below steps:
Step-3: After upload your file File → Download as → Comma-seperated values (.csv, current sheet)
Step-4: Your file will be start downloading.
Note: Don't forget to remove space from file name.
What's New
You can watch all video guides for new features at here →(click me)
General Options
You can manage general configurations from the app admin. You can also Skip none fields (drodpowns) via one of the general configurations. You can show or hide vendor details, SKU details, etc. You can also set the Ymm Product Result Page image dimension.
Go to Admin → Apps → C: Year Make Model Search → How to Use It → General
Manage YMM Design
You can easily set or manage the basic colour scheme for the YMM app through the app admin as per your theme's look.
Go to Admin → Apps → C: Year Make Model Search → Manage YMM Design
How to set logo/background image for YMM Searchbox?
Step-1: First please go to Admin → Content → Files section. Then, as you`ll see in the screenshot below, you`ll need to upload your logo and background image that you want to use for the YMM searchbox. After the image is uploaded successfully, you`ll need to click on the link in front of the image that is uploaded to copy its path. See screenshot below to get an idea:
Step-2: Now, please go to Apps → C: Year Make Model Search → Manage YMM Design → YMM Searchbox
Here, you`ll need to add those copied image paths in front of that setting, which means if you want to display a logo inside the YMM Searchbox, for instance, then you`ll need to paste the copied logo image path to its corresponding setting, i.e., Logo Image Name then click on the Save button! Also, here is an option to display the logo either at the top (center), bottom (center), left, or right. See the screenshot below to get an idea:
You (the admin) can set how many products per row will be displayed on the YMM products result page.
Go to Admin → Apps → C: Year Make Model Search → How to Use It → General → YMM Result Page Settings then you`ll see this option like below screenshot:
Front-end Result:
Light/Dark Colour Scheme:
By default our app comes in two default colour schemes: dark or light. That you can change it from Manage YMM Design tab just by toggling the below switch!
You can watch video guide for this feature by (click here)
i. YMM Searchbox:
ii. YMM Products Result Page:
Light Color Scheme:
Dark Color Scheme:
iii. Fitment Box [Pro Plan Feature]:
iv. Compatibility Chart/Table [Pro Plan Feature]:
User Friendly YMM Dropdowns
This feature will provide ease to your customers by allowing them to choose one of the dropdown values, and the next in the chain will be opened automatically. Customers can also search inside the YMM dropdown values.
Go to Admin → Apps → C: Year Make Model Search → How to Use It → General then follow below listed screenshot.
Front-end Result:
Skip None YMM Dropdowns
Do you have YMM data like the below screenshot?
In above screenshot, you can see each YMM row does not contain value for the Trim / Application dropdown, meaning some of specific YMM rows only needed value for the Trim / Application dropdown. Then, do you want to skip the "Trim" dropdown on the front-end for those YMM rows that do not contain "Trim" value at all and show next to next available dropdown value, i.e., "Application" to them?
To enable this feature, please go to Admin → Apps → C: Year Make Model Search → How to Use It → General then follow below listed screenshot.
Tip: Just go to Admin → Apps → C: Year Make Model Search → Manage YMM tab and click on the Publish HTML button once to publish the latest changes of YMM dropdowns to the site.
Front-end Result:
For Year = 2017, Make = Hyundai, Model = I3, Trim = None (no trim exists for this ymm row), Application = A1 then Trim dropdown is skipped and next to next dropdown i.e. Application is displayed to your customers. On changing the model dropdown, the trim dropdown is skipped, and data from the application dropdown, if available, will be fetched and displayed to your customers. [Reduce one step (quick YMM data loading)]
Send YMM Information to Cart/Checkout? [Pro Plan Feature]
To receive precise YMM information searched by the customer inside the Order section, by default, your customer will need to go through all YMM field selections, and you (the admin) will receive accurate YMM details for each line item in the Order. Your customers can also see the searched YMM information belonging to each product during checkout, like below screenshot.
You (Admin) will receive accurate ymm information underneath each line item in the Orders section, just like in the screenshot below.
Steps to configure this Pro Plan Feature:
Step-1: To Enable this Pro Plan Feature, please go to Admin → Apps → C: Year Make Model Search → How to Use It → Pro Plan Features section then follow below listed screenshot.
Step-2: If you haven't set the YMM searchbox on the product details page yet, then only you`ll need to set or show the YMM searchbox on the product details page via any of the techniques listed below:
How to display YMM Fitment Match on Product details pages in Online Store 2.0 or Vintage theme? Check it out video tutorial by (click here)
Technique-1 (Via App Block)
You can display YMM searchbox on online store's Product details page via "App Block" just by follow below screenshot then click on "Save" button at top right corner! You can drag and drop apps section at any spot and add our App block, where you want to display YMMBox on your website's product details page.
Technique-2 (Via App Shortcode)
You can paste above shortcode inside the product template file to display YMMBox on product pages, like below screenshot.
NOTE: Depending on your theme, exact template may differ. If you're not sure where to paste Template Code, please feel free to contact us at →supportshpfy@capacitywebsolutions.com
Step-3 (Optional): If you (the admin) want to display selected YMM information inside the customer's Order Confirmation email receipt as well as in your (the admin's) new Order email receipt, then you can do so by pasting the below codes into your email notification templates.
i. For Customer's Order Confirmation Email Receipt:
How it will work? See the screenshot below to get an idea.
ii. For New Order Admin Email Receipt:
How it will work? See the screenshot below to get an idea.
***IMPORTANT NOTES for this Feature:
i. If you`re not sure for any of above quick shortcodes and want to use that feature then no worries you can simply drop an email at →supportshpfy@capacitywebsolutions.com. For displaying the YMM searched information inside email notification templates, please provide admin login details with themes, apps, products, orders, and settings section access to us.
ii. This feature will send all YMM field information that is selected by the customer to the cart if the product matches (item fits) the current YMM search and further on checkout pages by default when you (the admin) enable this setting, but it will not work by default with your theme's minicart. As every theme has different files and structures, it is not possible to connect our App with your theme's minicart. If you (the admin) want to show selected YMM information inside your theme's minicart, then it will be necessary to do customizations on your theme's end. For that, you can send custom queries or requirements via email to us at →supportshpfy@capacitywebsolutions.com
Markets (Multi Languages & Multi Currencies)
You can watch video guide for below by (click here)
Shopify Markets is a cross-border management tool that helps you identify, set up, launch, optimize and manage your international markets - all from a single store.
Through the Shopify Markets feature, you can set multiple languages and multiple currencies. So, based on the Shopify Markets feature, our app introduces this new feature, i.e. the Markets feature, through which our app contents will be managed in multiple languages with multi-currency support.
!IMPORTANT NOTE: To manage multiple languages for your store, you`ll need to install the Shopify app, i.e. Shopify Translate & Adapt, that provides functionality for managing your store's product data into multiple languages. Our YMM App will just display product contents stored in multiple languages that are being managed through the Shopify App, i.e. Shopify Translate & Adapt. You can install Shopify Translate & Adapt app by (click here)
How do I first set up multiple languages and multiple currencies in "Shopify Markets"?
Step-1: Go to Admin → Settings → Markets section in your shopify store from admin side. So, you can add new market just like below screenshot:
You can fill up new market name and specify regions/countries belongs to this market just like below screenshot:
For instance, enter a market name like "Spanish Market" and specify the country or regions as Spain.
Step-2: Now, it's time to add store languages! Go to Admin → Languages section from shopify admin side of your store. So, you can add multiple languages for your store just like below screenshot:
!IMPORTANT NOTE: Language must be published on your store, and then only our YMM app will display product contents stored in multiple languages on the front-end.
Step-3: Now, you`ll need to assign languages to the created market. So, for this, go to the Admin → Markets section inside your Shopify admin store then open created market details page. Then, as shown in the screenshot below, click on the Manage link to assign the created language to this market:
You can now proceed with the steps outlined in the screenshot below:
Step-4: Now, it's time to set currency for this newly created market; for instance, EUR for the Spain market. So, for this, go to the Admin → Markets section inside your Shopify admin store then open created market details page. Then, as shown in the screenshot below, click on the Manage link to specify the currency for this market:
You can now proceed with the steps outlined in the screenshot below:
How do I set up multiple languages and multiple currencies in the "YMM App" via the "Markets Feature"?
After you've setup or created markets with language and currency configurations in Shopify itself, based on that, our app is provided with a "Markets Feature" that allows you to display a product's title in multiple languages, and the price will be based on the current currency of the market on the YMM result page.
You`ll need to follow the below steps and details to get an idea of how you can run multiple languages and multiple currencies for the YMM App.
Step-1: Go to the Admin → Apps → C: Year Make Model Search → How to Use it → General section, then scroll down to the bottom of the page to find one of the settings, namely, Enable "Markets" feature for YMM. Simply select "Yes" for this option and click the Save Settings button. See the below screenshot to get an idea:
Step-2: (To manage multiple languages) , first go to the Admin → Apps → C: Year Make Model Search → Translations → General Texts section.
General Texts: Here, you can enter translations for your chosen language for each general text, then click on the "Save" button! See the screenshot below to get an idea.
!IMPORTANT NOTE: If any field is left blank, the default text in English will be displayed on the front end.
See the front-end result for Spanish Language:
i. YMM Searchbox in Spanish Language:
ii. YMM Result Page in Spanish Language + Euro Currency:
iii. Fitment Block:
A. Item Fits YMM Block in Spanish Language:
B. Item Does Not Fit YMM Block in Spanish Language:
iv. YMM Compatible Table in Spanish Language:
Step-3: (To manage multiple currencies) , first go to the Admin → Apps → C: Year Make Model Search → How to Use it → General section, then scroll down to the bottom of the page to find one of the settings, namely, Display price with currency code. Simply select "Yes" for this option and click the Save Settings button. See the below screenshot to get an idea:
!IMPORTANT NOTE: If you have multiple currencies, for example, AUD and USD, this setting option will be useful for your customers as both currencies' symbols are the same. So, for AUD, the price will be displayed along with the currency code, for instance: $5.0 AUD, and for USD, the price will be displayed along with the currency code, for instance: $10.00 USD.
Free Plan available for Development Stores
Just setting up your store? You won’t have to pay until your store is ready.
For Affiliate / Development / Partner Test Stores, We`ve provided Development (Free Plan).
When you first install the app and your store is either a partner test store or a development store, you can grab the benefit of the free plan of our YMM app, just like in the below screenshot.
By clicking on the Upgrade button in the above screen, you`ll be redirected to the charge window, just like in the below screenshot. Here in Free Plan, you'll still need to click on the Approve button for this test charge.
That's it!!!
You've installed our app with a free development plan. You can test or check our YMM app in your development stores. The Development (Free) Plan contains the following limitations:
You can add up to a maximum of 100 YMM records for testing.
You can add up to a maximum of 5 YMM fields (dropdowns) for testing.
You can export a maximum of 1000 products for testing.
Later on, you can easily switch to the paid plan of our app, either Basic, Pro, or Premium, with a monthly or annual charge, from our app's dashboard by clicking on the Plan Upgrade button, or once your Shopify Store's plan changed from Development to anything like Shopify Plus, Advance, or Basic Shopify then you`ll be prompted to go with the paid plan of our app.
"Required Fields" Feature:
We have provided a new setting option, i.e., Choose "Required (*)" YMM Fields in the "General Settings" section of our app.
Through this option, you (Admin) can set required YMM fields, so the "YMM Search" button will be enabled after selections of all required YMM fields, which results in a pin-point exact search.
Go to Admin→Apps→C: Year Make Model Search→How to Use It→General→General Settings then follow below listed screenshot.
NOTE: The "Required YMM Fields" setting option is integrated with the "Skip None YMM Dropdowns" setting option.
Consider, for instance, that if you've created ymm fields such as Year, Make, Model, and Engine, out of which "Engine" exists in a "Skip None YMM Dropdowns" list and also "Engine" exists as a "Required YMM Field," then on the front-end, Year, Make, and Model dropdowns will be showing up, and "Engine" dropdown will be displayed only if it exists for the current ymm selections. If "Engine" dropdown exists, then it will be mandatory to select this field, and only the "YMM Search" button will be enabled; otherwise, the "YMM Search" button will be enabled after selections of Year, Make, and Model dropdowns.
"URL Redirect" Feature
Through this feature, after "YMM Search" is performed, you (the admin) can redirect your customers to the URL that you've assigned to that YMM row instead of redirecting them to the default YMM Products Result page.
Go to Admin→Apps→C: Year Make Model Search→How to Use It→General→"URL Feature" Settings then follow below listed screenshot.
Q1: What does the "Default URL" setting option do?
Answer: You (the admin) can specify the default URL in this textbox. So, if you left blank to assign the URL to any YMM row, then customers will be redirected to the default URL specified here.
Q2: What does the Set YMM dropdown selected on the "Landing Page" setting do?
Answer: This will show YMM drop-downs selected on the landing page automatically, meaning you don't even need to add the "?rq=[YMM]" token in the "URL" value.
There are 3 use cases for this feature, which are listed below.
i. Custom Redirect: You can watch video guide by (click here)
ii. Filter 1.0 (Tag Based Filtering): You can watch video guide by (click here)
iii. Filter 2.0 (Metafields Based Filtering): You can watch video guide by (click here)
Q: What is the "Custom Redirect" use of the "URL feature"?
Answer: After clicking on the "Search" button instead of redirecting to the YMM Products Result Page, you (Admin) can specify a redirection URL for each YMM row, where your customers will be redirected. Please see screenshot below to get an idea:
Go to Admin→Apps→C: Year Make Model Search→How to Use It→General→"URL Feature" Settings then follow below listed screenshot.
Step-1: Set Enable "URL Redirect" feature for YMM = Yes
Step-2: Set Use "URL Feature For Collection Filtering"? = No
Step-3 (Optional): Enter Default "URL"
NOTE: You (the admin) can specify the default URL in this textbox. So, if you left blank to assign the URL to any YMM row, then customers will be redirected to the default URL specified here.
By doing this, you can enter "Redirection URL" to each one of the YMM rows either via the "Add YMM" section or via "CSV".
(i) Add YMM Section:
From here, you can add or assign "Redirect URL" to this YMM row by inputting the URL value in a textbox. You can follow below listed screenshot:
Q: What does the "New Window?" setting option do?
Answer: The "New Window?" setting will accept values of either 0 or 1. You (Admin) can enter value = 1 for "New Window?" and then it will open that redirect URL in a new tab. For instance, if the redirect URL is an external site URL, you can set the "New Window?" value to 1, like: https://google.com. If the redirect URL belongs to the same Shopify website, then you can keep "New Window?" equal to blank, and the default value is 0, so it will open the URL in the same tab.
(ii) Via CSV Import:
You (the admin) can enter "Redirect URL" for each YMM row via a CSV file like this. If you want to open a redirect URL in a new tab, then only you (the admin) will need to set value = 1 in the "New Window?" column. You can follow below listed screenshot:
Tip: Just go to Admin → Apps → C: Year Make Model Search → Manage YMM tab and click on the Publish HTML button once to publish the latest changes of YMM dropdowns to the site. Then you can check or test this newly added YMM row on the front-end.
Do you have YMM data like the below screenshot?
In the above screenshot, you can see there are 2 YMM rows with the same year = 2015 and make = TATA, but each row has different models, such as Nano and Tiago, and different redirect URL(s).
Tip: For the above scenario, you (the admin) can set "required YMM fields" such as model, just like in the below screenshot. In our YMM app, the first two ymm fields, i.e., year and make, are always mandatory, so you can choose the rest of the fields here.
Through this, "redirections" will work accurately. So, on the front end, when the customer selects Year = 2015, Make = TATA, Model = NANO, then clicking the "Search" button will redirect to this URL accurately: https://test.myshopify.com/pages/my-brands.
URL Tokens:
You (the Admin) can use "Tokens" in the "URL" value, such as [Year], and then it will be replaced with the actual year dropdown label, i.e., for instance, 2019.
Also, you can use this token such as ?rq=[ymm] OR &rq=[ymm] in the URL value; through this, you can show values selected inside YMM dropdowns.
For instance, URL value will be like:https://test.myshopify.com/pages/my-brands?rq=[ymm]&year=[Year]&make=[Make]&model=[Model]
On the front-end, by selecting year = 2019, make = Tata, and model = Nano, clicking the "Search" button will redirect the customer to this URL: https://test.myshopify.com/pages/my-brands?rq=yr_2019__mk_tata__md_nano&year=2019&make=Tata&model=Nano. On this "My Brands Page", YMM dropdowns will be showing up with values selected such as: 2019, Tata & Nano by passing ?rq=[ymm] token in URL value.
Q: What is the "Filter 1.0 (Tag Based Filtering)" use of the "URL feature"?
Answer: If you don't want to redirect to the YMM products result page but instead redirect to the collection page, where filtering will be performed based on the assigned product tags, then you can use this option in our app by following the below-listed details.
!IMPORTANT Note: Our YMM app will not create any Product tags. You (Admin) has to create product tags by your own end. You can use the "URL Feature" of our app for collection filtering by product tags. But for this, you`ll need to ensure that YMM dropdown labels are the same as product tags then only filtering will work.
(i) Product Tags: Please see the below screenshot to get an idea of the product tags that you (the admin) entered inside the product: 2019, Hyundai, I3.
(ii) YMM Dropdown Labels: Please see the below screenshot to get an idea of how the YMM drop-down labels must be exactly the same as the product tags.
Go to Admin→Apps→C: Year Make Model Search→How to Use It→General→"URL Feature" Settings then follow below listed screenshot.
Step-1: Set Enable "URL Redirect" feature for YMM = Yes
Step-2: Set Use "URL Feature For Collection Filtering"? = Yes
Step-3: Set Choose Filter Type = Filter 1.0 (Tag Based Filtering)
Step-4 (Optional): Enter Default "URL"
NOTE: You (the admin) can specify the default collection URL in this textbox. So, if you left blank to assign the Collection URL to any YMM row, then customers will be redirected to the default Collection specified here.
By doing this, you can enter "Redirection URL" to each one of the YMM rows either via the "Add YMM" section or via "CSV".
(i) Add YMM Section:
From here, you can add or assign "Redirect URL" to this YMM row by inputting the Collection URL value in a textbox. You can follow below listed screenshot:
(ii) Via CSV Import:
You (the admin) can enter "Redirect URL (Collection URL)" for each YMM row via a CSV file like this. You can follow below listed screenshot:
Tip: Just go to Admin → Apps → C: Year Make Model Search → Manage YMM tab and click on the Publish HTML button once to publish the latest changes of YMM dropdowns to the site. Then you can check or test this newly added YMM row on the front-end.
Do you have YMM data like the below screenshot?
In the above screenshot, you can see there are 2 YMM rows with the same year = 2019 and make = Hyundai, but each row has different models, such as I3 and I20, and different redirect URL(s).
Tip: For the above scenario, you (the admin) can set "required YMM fields" such as model, just like in the below screenshot. In our YMM app, the first two ymm fields, i.e., year and make, are always mandatory, so you can choose the rest of the fields here.
Through this, "redirections" will work accurately. So, on the front end, when the customer selects Year = 2019, Make = Hyundai, Model = I3, then clicking the "Search" button will redirect to this URL accurately: https://test.myshopify.com/collections/hyundai-i3/2019+hyundai+i3.
URL Token:
You (the admin) can use this token such as ?rq=[ymm] OR &rq=[ymm] in the URL value; through this, you can show values selected inside YMM dropdowns on the Collection Page.
CSV Screenshot for instance:
Even though you can use this token in "Default URL" to show values selected inside YMM dropdowns on the Collection Page.
Front-end Result:
(C) Filter 2.0 (Metafields Based Filtering) - URL Feature Setting:
Q: What is the "Filter 2.0 (Metafields Based Filtering)" use of the "URL feature"?
Answer: If you don't want to redirect to the YMM products result page but instead redirect to the collection page, where filtering will be performed based on the assigned product metafields, then you can use this option in our app by following the below-listed details.
!IMPORTANT Note: Our YMM app will not create any Product Metafields. You (Admin) has to create product metafields by your own end. You can use the "URL Feature" of our app for collection filtering by product metafields. But for this, you`ll need to ensure that YMM dropdown labels are the same as product metafields then only filtering will work.
(i) Product Metafields: Please see the below screenshot to get an idea of the product metafields that you (the admin) entered inside the product: 2019, Hyundai, I3.
(ii) YMM Dropdown Labels: Please see the below screenshot to get an idea of how the YMM drop-down labels must be exactly the same as the product metafields.
Go to Admin→Apps→C: Year Make Model Search→How to Use It→General→"URL Feature" Settings then follow below listed screenshot.
Step-1: Set Enable "URL Redirect" feature for YMM = Yes
Step-2: Set Use "URL Feature For Collection Filtering"? = Yes
Step-3: Set Choose Filter Type = Filter 2.0 (Metafields Based Filtering)
Step-4: Set value for Enter Filter 2.0 Query Parameters = [Year]=filter.p.m.custom.year~[Make]=filter.p.m.custom.make~[Model]=filter.p.m.custom.model~
NOTE: This is just for an example such as: [Year]=filter.p.m.custom.year~[Make]=filter.p.m.custom.make~[Model]=filter.p.m.custom.model~
Which value should come in this textbox i.e. "Enter Filter 2.0 Query Parameters"?
First you can get our YMM app field keys just like below screenshot:
Consider for instance: [Year]=filter.p.m.custom.year~
Here, [Year] is our YMM app field key. Followed by the equal sign "=", then after you (Admin) have to provide product metafield filter 2.0 key details (namespace-key value pair) in front of [Year]=, at last, the tilde sign "~" is provided. So, the final value will be: [Year]=filter.p.m.custom.year~.
Similarly, in front of each YMM field, you can provide product metafield filter 2.0 key details (namespace-key value pair) by following the same pattern.
Help Screenshot:
Step-5 (Optional): Enter Default "URL"
NOTE: You (the admin) can specify the default collection URL in this textbox. So, if you left blank to assign the Collection URL to any YMM row, then customers will be redirected to the default Collection specified here.
By doing this, you can enter "Redirection URL" to each one of the YMM rows either via the "Add YMM" section or via "CSV".
(i) Add YMM Section:
From here, you can add or assign "Redirect URL" to this YMM row by inputting the Collection URL value in a textbox. You can follow below listed screenshot:
(ii) Via CSV Import:
You (the admin) can enter "Redirect URL (Collection URL)" for each YMM row via a CSV file like this. You can follow below listed screenshot:
Tip: Just go to Admin → Apps → C: Year Make Model Search → Manage YMM tab and click on the Publish HTML button once to publish the latest changes of YMM dropdowns to the site. Then you can check or test this newly added YMM row on the front-end.
Do you have YMM data like the below screenshot?
In the above screenshot, you can see there are 2 YMM rows with the same year = 2019 and make = Hyundai, but each row has different models, such as I3 and I20, and different redirect URL(s).
Tip: For the above scenario, you (the admin) can set "required YMM fields" such as model, just like in the below screenshot. In our YMM app, the first two ymm fields, i.e., year and make, are always mandatory, so you can choose the rest of the fields here.
Through this, "redirections" will work accurately. So, on the front end, when the customer selects Year = 2019, Make = Hyundai, Model = I3, then clicking the "Search" button will redirect to this URL accurately: https://test.myshopify.com/collections/hyundai-i3?filter.p.m.custom.year=2019&filter.p.m.custom.make=Hyundai&filter.p.m.custom.model=I3.
URL Token:
You (the admin) can use this token such as ?rq=[ymm] OR &rq=[ymm] in the URL value; through this, you can show values selected inside YMM dropdowns on the Collection Page.
CSV Screenshot for instance:
Even though you can use this token in "Default URL" to show values selected inside YMM dropdowns on the Collection Page.
Front-end Result:
"Export YMM CSV" from Product's Metafields for "Filter 2.0" Feature:
You can watch video guide for below by (click here)
If you (Admin) have already added year, make, and model data inside your product's metafields & want to use the Filter 2.0 feature (metafields-based filtering) via our YMM App, then no worries; you can Generate YMM CSV on the fly by pulling data from your Product's metafields.
Tip:Make sure you've enabled Filter 2.0 (metafields-based filtering) option inside the General section of our app, like the below screenshot, then and only you can generate YMM CSV file from your product's metafields.
Feature Configuration Steps:
Go to Admin → Apps → C: Year Make Model Search → Import/Export then you`ll see this option like below screenshot:
Once you've clicked on the Submit button, then you'll see a pop-up like below screenshot:
Here, in this pop-up, you (Admin) will need to fill up the year (product metafield), make (product metafield), model (product metafield)namespace-key details in this format i.e. namespace.key.
For instance: You (Admin) have created a year (product metafield); then you can copy "namespace.key" details by going to the Admin → Settings → Custom Data → Products Metafields section, just like the below screenshot.
Once you (Admin) have copiednamespace.key for the year (product metafield), then you have to supply this detail accurately inside a pop-up like the below screenshot:
Once you've filled out the form, then afterwards scroll down & click on the Start Process button!
Once the process is started, then you can see the process in a RUNNING state like the below screenshot. From this running state, you can cancel the process if you wish.You can close the window if you wish. Once the process is completed, then you'll be notified on your store's email address.
Once you get the below email on your store's email address about the process being completed…
Then after, you'll have to Go to Admin → Apps → C: Year Make Model Search → Import/Export → Click on the Submit button, and then you'll see final step i.e. Export YMM CSV button, and on clicking this button, a download link for the CSV file will be generated, through which you can download the YMM CSV file.
Tip: You (Admin) can use Date filtering provided in first step during products export process that will drill down products based on created at dates, so next time, you can generate ymm csv for the latest products added only.
Now, you can import this Generated YMM CSV from the Import/Export tab of our app. We've provided several import options in our app that you can see by click me
Tip: Just go to Admin → Apps → C: Year Make Model Search → Manage YMM tab and click on the Publish HTML button once to publish the latest changes of YMM dropdowns to the site.
Frequently asked questions:
Q1: What to do if you (Admin) do not receive any email about the bulk products export process being completed?
Answer: If somehow the process is not completed from its RUNNING state & you also do not receive any email about the process being completed, then no worries; you can still download the partial data CSV file from the Import/Export section by clicking on the Submit button, and then you'll see the below screenshots:
Once you've clicked on the Submit button then you'll see like below screenshot. So, either you can download partial data CSV file OR re-try the process by clicking on the Click me button!
***NOTE: In case a bulk operation fails on the Shopify server end, as they've mentioned in the below screenshot, either you (Admin) can retry the process OR retry the process with date filtering, so if it was failed due to a large products data set, then date filtering will be useful to drill down products based on their created-at dates, and the 2nd time, chances are less that the bulk operation will fail.
[Intermittent error means if the operation is retried once it is failing, then the 2nd time, it will not fail like that.]
Q2: What if the generated YMM CSV will output if my products have year, make, and model data entered like below?
Year = 2015, 2016
Make = Tata
Model = Nano
Answer: Then it`ll generate Combination YMM Rows like: 2015 Tata Nano, 2016 Tata Nano like below screenshot.
"Infinite Scrolling" (Lazy Load Products):
Infinite scrolling will load products on the YMM result page lazily. So, it will decrease initial page load times.
Go to Admin → Apps → C: Year Make Model Search → How to Use It → General → YMM Result Page Settings then you`ll see this option like below screenshot:
NOTE: Through "Infinite Scrolling", you (Admin) can show more than 50 products on one page by scrolling down. So, products will be shown on the fly to the user, which reduces page loading time and improves the user experience.
My Garage [Pro Plan Feature]
You can watch video guide for below by (click here)
My Garage feature will allow your customers to save multiple bikes into their own customer account easily.
Go to Admin→Apps→C: Year Make Model Search→How to Use It→Pro Plan Features then follow below listed screenshot.
Feature Configuration Steps:
(i) Set Enable "My Garage"? = Yes then click on the Save button!
(ii) [Optional] Set "My Garage Icon Image" by supplying image URL in below text field.
***NOTE: If left blank, then the default garage icon will show up; otherwise, you can set the garage icon of your choice. Click here to get an idea of which value should come here.
(iii) My garage is provided with Three styles.
Tip: To quickly test out how My Garage is working, we recommend you to choose Default Style; otherwise, there are two more global styles available that will show "My Garage Box" sitewide, either in the header or as a modal popup.
A. Default (Under YMMBOX) [Non Global Style]: This will show "My Garage" underneath the YMM Searchbox. So, this style is not a global one, which means if YMMBox is shown on specific pages only, then my garage will also show up on specific pages only, not site-wide.
Admin Setting:
Front-end Result:
Tip: You can also show 'Your Current Vehicle: ' under YMMBOX by configuring the 'Show My Current Vehicle' feature. (Click me) to get an idea.
B. Header Dropdown Menu [Global Style]: Through this style, my garage box will show up as a Drop down menu by clicking on the My Garage icon inside the header.
***Note: For this style, you (Admin) will need to paste My Garage shortcode inside the header file of your theme.
"My Garage" Shortcode:
Help screenshot for where shortcode needs to be pasted:
!Important Note:Every theme has different files & structure, so the filename will vary based upon the theme. If you aren't sure then no worries, please drop us an email at supportshpfy@capacitywebsolutions.com, and we'll be able to help you to set it out.
Admin Setting:
Front-end Result:
Tip:You can also show 'Your Current Vehicle: ' under YMMBOX by configuring the 'Show My Current Vehicle' feature. (Click me) to get an idea.
C. Sticky Pop-Up [Global Style]: Through this style, My Garage box will be showing up as a modal pop-up once clicking on the My Garage icon.
My garage sticky icon can be set either on the left or the right on the website.
***Note: For this style, you (Admin) will need to paste My Garage shortcode inside the theme.liquid file of your theme before closing body tag.
"My Garage" Shortcode:
Help screenshot for where shortcode needs to be pasted:
Admin Setting:
Front-end Result:
My Garage Sticky Icon Orientation: Left or Right
By clicking on My Garage sticky icon, my garage contents will be displayed inside a modal pop-up.
Tip: You can also show 'Your Current Vehicle: ' under YMMBOX by configuring the 'Show My Current Vehicle' feature. (Click me) to get an idea.
My Garage → Save My Bike
Hot
You can watch video guide for below by (click here)
Q: What does the 'Save My Bike' option do?
Answer: 'Save My Bike' option of the 'My Garage' feature will allow your customers to save their searched vehicles inside their customer account.
Feature Configuration Steps:
Step-1: Go to Admin→Apps→C: Year Make Model Search→How to Use It→Pro Plan Features then follow below listed steps one by one.
Step-2: Scroll down to 'My Garage Feature Settings' section then follow below screenshots:
Enable "My Garage"? = Yes
Enable "Save My Bike" = Yes
Step-3 (Optional): You can change 'My Garage Style' from 'Default Style' to anyone, but we recommend you first go with 'Default Style' to get an idea about feature workings.
Step-4: Then after, please follow steps listed underneath of 'Enable Save My Bike' setting section inside 'Pro Plan Features' tab of our App just like the below screenshots.
That's it...
Front-end Result of 'Save My Bike' Feature:
i. My Garage Box:
→ If a customer is not logged in yet, then it will show a message to log in like below:
→ If the customer is already logged in, then it will show the 'Save' button to save the searched vehicle inside my customer's account, just like below.
ii. YMM Products Result Page:
→ If a customer is not logged in yet, then by clicking on Save My Bike button will show message like below:
→ If the customer is already logged in, then they can save recent searched vehicle into their customer account by click on the Save My Bike button. That's it...
→ From this page, your customers can view their saved vehicles and products associated with saved vehicles, and also they can delete vehicles too, and even they can PUSH/save their recently searched vehicle into their customer account straightaway from this page too by clicking on "Add My Bike" button or clicking on the 'Save' button in front of that recently searched vehicle inside the 'Recent Search History' section. Please see the screenshot below to get an idea:
A. My Garage Page [Light Mode]:
B. My Garage Page [Dark Mode]:
→ By default our app comes in two default colour schemes: dark or light. That you can change it from Manage YMM Design tab just by toggling the below switch!
Show "My Current Vehicle"
You can watch video guide for below by (click here)
This widget will display currently searched YMM values under the YMM search box throughout the website. Currently searched YMM values will keep in the user's browser's COOKIE for at atleast 7 days.
Go to Admin→Apps→C: Year Make Model Search→How to Use It→General then follow below listed screenshot.
Front-end Result:
Manage color options:
Manage texts in multiple languages:
"Filters" Feature
You can watch video guide for below by (click here)
Q: Do you want "Additional Custom Filters" on the "YMM Result Page" after YMM has been searched?
Answer: No worries, YMM App has now providedAdditional custom filters on the YMM Result Page that will allow your customers to drill down products more accurately, which they want easily.
For instance, you're selling Washing Machines & want Custom Additional Filters on the YMM result page, like product type, capacity (washing), color, and features. Then you (Admin) can do so by following the below-listed steps one by one.
Feature Configuration Steps:
i. Go to Admin → Apps → C: Year Make Model Search → Manage Fields then createCustom Fields (Additional Filter Fields), such as, for instance:
Product Type
Capacity (Washing)
Color
Features
See the help screenshot to get an idea:
ii. Go to Admin → Apps → C: Year Make Model Search → Add YMM then Add Records like below.
***NOTE: In each YMM row, you can assign product ID(s) that are relevant to that YMM row.
OR
You (Admin) can prepare YMM CSV & import it with the import/export feature of the YMM app.
See the help screenshot to get an idea:
iii. Go to Admin → Apps → C: Year Make Model Search → General then follow below listed screenshot.
iv. Tip: Just go to Admin → Apps → C: Year Make Model Search → Manage YMM tab and click on the Publish HTML button once to publish the latest changes of YMM dropdowns to the site. Then you can check or test these newly added YMM rows on the front-end.
Front-end Result of 'Filters' Feature:
A. Filters Feature [Light Mode]:
See 'Filtered Result':
Customers can choose multiple values for filtering simultaneously, such as Product Type = front-loading & top-load.
Filters will be kept during going back & forth from the browser's TAB. So, customers will not need to re-select any filters again.
B. Filters Feature [Dark Mode]:
"Filters" Feature in 2 Styles:
Filters feature is provided with 2 styles.
Go to Admin → Apps → C: Year Make Model Search → General then follow below listed screenshots.
i. Style-1 (Show Filters on Button click horizontally):
You can watch video guide for below by (click here)
Back-end Options:
Front-end Result:
Now, you (Admin) don't want to show all of the filter fields by default inside the "Filter Fields Box"; then you can set "Select the number of filters to be shown for the desktop:" for instance, 3.
See Back-end Setting:
See Front-end Result:
On click of the "More Filters" button, the 4th filter field, such as "Features", or the next filter fields will be shown inside the "Filter Drawer". You can see all of the filter fields will be showing up inside the "Filter Drawer".
ii. Style-2 (Show Filters on Button click inside right end drawer):
See Back-end Setting:
See Front-end Result:
Mobile view for "Filter" Feature: It will be displayed as Filter Drawer by clicking on the "Filter" button.
"Filters" feature more Configurations:
A. General Configurations: Go to Admin → Apps → C: Year Make Model Search → General then follow below listed screenshot.
i. Show "Searchbox" within "Filter Box":
ii. Display "Show More" button:
iii. Show Products count in front of checkbox:
B. Translations Configurations: Go to Admin → Apps → C: Year Make Model Search → Translations → General Texts then follow below listed screenshot to manage "Filters" feature into Multi Languages managed via Shopify Markets.
C. Colors Configurations: Go to Admin → Apps → C: Year Make Model Search → Manage YMM Design → YMM Result Page then follow below listed screenshot to manage "Filters" feature look (Design) that will match with your website's theme.
"Custom Data" Feature
You can watch video guide for below by (click here)
This feature will displayAdditional Product Information on the YMM Result Page by clicking on the View Details button that is being kept inside the product's metafields.
Go to Admin → Apps → C: Year Make Model Search → How to Use It → General then follow below listed screenshot.
Front-end Result:
Feature Configuration Steps:
i. (Optional): For instance, you (Admin) want to show 'Additional information' for a washing machine underneath that product, such as product weight/height/colour/dimension etc.
Then either you already have additional data set up inside the product's metafields, but if not, then you can easily set up your products with additional details populated from Metafields by going to Admin → Settings → Custom Data Section & creating product metafields definitions there first.
See the reference screenshot to get an idea:
Then after Go to Admin → Products then select any one product to add metafield values to it.
See the reference screenshot to get an idea:
***NOTE: If you've already set up your products with product metafields and just want to show that additional information on the YMM result page, then you can skip this step-1.
ii. Go to Admin → Apps → C: Year Make Model Search → How to Use It → General → "Custom Data" Feature Settings section then follow below listed screenshots.
Set Show 'Custom Data' on YMM result page as Yes.
Click on +Add button to add custom data details such as Namespace/Key/Type.
Once you've clicked on +Add button then you'll see textboxes added below in which you have to provide namespace-key & type details to map/show that product metafield value as additional information on the YMM result page.
For instance, you (Admin) want to show product height as additional information, then you've to supply the correct namespace key & type details for Product Height metafield, so take namespace-key & type details from Admin → Settings → Custom Data → Product Metafields section just like below screenshot.
Now, you (Admin) have to supply these details, such as namespace-key & type, inside the 'Custom Data Feature Settings' section, just like the below screenshot:
***NOTE:In the Basic Plan, you can show 4 additional details on the YMM result page; otherwise, in the Pro/Premium plan, you can get a limit of 8 additional details being displayed.
Below metafield types are supported in our App.
Front-end Result:
'View Details' button will be shown under Product like below.
By clicking on the 'View Details' button will show Product's Additional Information like below.
Question: Do you want to show a title such as 'Product Height before the value, i.e., 1170 mm?
Tip: Go Admin → Apps → C: Year Make Model Search → Translations → General Texts section then scroll down to the section Custom Data [Metafields] Translations Settings then here you can enter title/texts into multiple Languages. See the screenshot below to get an idea.
See Front-end Result:
That's it...
"Custom Data" Feature in 2 Styles:
"Custom Data" feature is provided with 2 styles.
i. Style-1 [Display "Additional Info" underneath of Product]:
Back-end Option:
Front-end Result:
Light Mode:
Dark Mode:
ii. Style-2 [Display "Additional Info" inside Pop-up]:
Back-end Option:
Front-end Result:
Light Mode:
Dark Mode:
→ By default our app comes in two default colour schemes: dark or light. That you can change it from Manage YMM Design tab just by toggling the below switch!
"Custom Data" feature more Configurations:
A. Translations Configurations: Go to Admin → Apps → C: Year Make Model Search → Translations → General Texts then follow below listed screenshot to manage "Custom Data" feature into Multi Languages managed via Shopify Markets.
!IMPORTANT NOTE: You can manage product's metafield value translations via Shopify Translate & Adapt App, see the screenshot below to get an idea. You can install shopify Translate & adapt app by (click here)
B. Colors Configurations: Go to Admin → Apps → C: Year Make Model Search → Manage YMM Design → YMM Result Page then follow below listed screenshot to manage "Custom Data" feature look (Design) that will match with your website's theme.
"Auto Search" Feature
You can watch video guide for below by (click here)
The "Auto Search" feature provides automatic search when the last dropdown value is selected, meaning no need to click on the 'Search' button inside the YMM search box. Even you (Admin) can hide the 'Search' button inside the YMM search box.
Go to Admin → Apps → C: Year Make Model Search → How to Use It → General then follow below listed screenshot.
Front-end Result:
Fitment Match [Pro Plan Feature]
Fitment Match provides confirmation on product details page that a product matches ymm search criteria.
How to display YMM Fitment Match on Product details pages in Online Store 2.0 or Vintage theme? Check it out video tutorial by (click here)
Frontend view:
i. When product fits for current ymm search:
ii. When product fits universally (if its universal product) for current ymm search:
iii. When product does not fit for current ymm search:
iv. You can also display "Fitment Badges" on the YMM result page like below:
Backend options:
Go to "How to Use it" tab then click on "Pro plan features" then you'll see options like below screenshot:
NOTE: This feature is available to users, who are on Pro or Premium plans only.
Fitment Compatibility Chart [Pro Plan Feature]
Fitment Compatibility Chart displays all product fitment data that belongs to ymm search criteria on product details page.
How to display YMM Compatibility Chart/Table in Online Store 2.0 or Vintage theme? Check it out video tutorial by (click here)
Frontend view (Desktop):
Frontend view (Mobile):
i. Compatibility List (In Mobile)
On click of any "Year" will display next ymm data in mobile view like below screenshot along with "Go Back" button.
ii. Compatibility Table (In Mobile)
New
Backend Options:
Go to "How to Use it" tab then click on "Pro plan features" then you'll see options like below screenshot:
NOTE: This feature is available to users, who are on Pro or Premium plans only.
Speed Up Configuration (New Feature)
Go to Admin → Apps → C: Year Make Model Search → Manage YMM
(i) Optimize YMM Data:
You'll need to type "OPTIMIZE" command in given textbox then click on the "Submit" button to delete duplicate ymm records.
Once you`ll click on the Submit button then you`ll see just like below screenshot in which you can clearly see how many duplicate records are there & then after to continue the process, you`ll need to click on the Continue button that will remove duplicate records. That's it...
Question: What is the use of YMM data optimization? Answer: Optimization will check and delete duplicate records from all your ymm records and this will decrease loading time on the front-end, due to adequate number of records.
From Here, You can turn "On/Off" for "Speed Up Mode Configuration", just like below screenshot:
*** IMPORTANT NOTE: If "Speed Up Mode" is set to "On" and you've made any changes in Year Make Model dropdowns (Like add,edit,delete or change in any other dropdown options or change front-end static texts like 'select','search','reset' etc. or if you've re-installed the APP recently) then you must Publish Static Year Make Model dropdowns again by click on 'Publish HTML' button inside 'Manage YMM' tab, so that your changes will reflect in frontend. If you're not sure for this then you can contact us at >> supportshpfy@capacitywebsolutions.com.
Question-1: Why to use "Speed Up Mode"? Answer: It provides seamless speed at time of page load means YMMbox dropdowns displayed much more faster than current.
Question-2: My customization work lost after I have used "Speed Up Mode" as "ON", what to do now? Answer: Yes, if you want to use the "Speed Up Mode" feature then it will upgrade our App files and if you/we have done customization prior for you then it will be lost. But no worries, we have kept older app files backup in your live theme. You can find backup files by go to snippets folder then please open this file i.e. "ymm-searchbox-old-cws-backup.liquid" and revert snippets/ymm-searchbox.liquid file contents with this backup file. You can still contact us if you want to speed-up YMM without losing customization work, we'll sort this out for you quickly! Don't hesitate to drop an email at > supportshpfy@capacitywebsolutions.com.
What's New
My Garage [Pro Plan Feature]
