Zen Cart custom software development, Zen Cart modules, Zen Cart Expert eCommerce Websites with Zen Cart!

Zen Cart Default Attribute

Zen Cart Default Attribute

A Zen Cart™ mod which allows single valued defaultable attributes (such as PDF-only downloads) can be added directly from a listing page, rather than from the product_info page only. This means your customers can add these products from the search page, category listing page, featured products page, or the new and all products pages.

Donate: This is free software. Show your appreciation by supporting my efforts. Donate

Relevance: Zen Cart™ 1.5.5 and above only. This feature is built in to Zen Cart v2

Current Version: 1.0a

Support Thread: Default Attribute Support Thread

Cost: Free, but donation appreciated

Installed Cost: $120.00 Buy Professional Installation by That Software Guy

Installation Difficulty: Moderate

Installation Instructions: click here

Location: Zen Cart Plugins, under Template Alterations

Download: Default Attribute in Zen Cart Plugins

Add-Ons: Coming soon: interoperability with my Zen Cart mods that facilitate adding products to the cart:
FAQ: click here

See it Live: Go to the document category my demo2 store. You will notice that the PDF document (product 180) can be added to the cart, even though it has an attribute (since it's a downloadable product).


In a stock Zen Cart install, products which have attributes - even if these attributes have only one value, such as a single download attribute - may not be added from the listing page. This mod permits you to overcome this restriction.

So that instead of seeing this:
Zen Cart without Default Attribute

Your customers see this:
Zen Cart with Default Attribute

Installation Instructions:

Note: This feature was taken from Zen Cart v2 and backported to 1.5.5 with the responsive_classic template. Merging it into another template can be done by calling zen_requires_attribute_selection at the same places in that template's files.

  1. Back up everything! Try this in a test environment prior to installing it on a live shop.
  2. cd to the 1.5.5 folder. Please note: This mod only works with Zen Cart 1.5.5.
  3. Rename the responsive_classic directories (under includes/modules and includes/templates) to the name of your template directory. Merge template and core file changes if needed.
  4. Copy the files to your cart's top level directory.
  5. Be sure you have the setting Admin->Configuration->Product Listing-> Display Product Add to Cart Button set to 1 or 2.

Major Versions

  • 1.0a 09/12/2016 - Fix for adding multiple products on listing page
  • 1.0 07/15/2016 - First Release


Q: What do you mean by "defaultable attributes" or "single valued defaultable attributes?"
A: The two terms mean the same thing. They're just attributes for which a default value can be selected without needing input from the product info page. "Single valued" means the attribute has just one value. For example, a radio button with just one value (such as "PDF" or "ZIP file") is single valued. A radio button with two values (such as "red" or "green") would not be single valued. Similarly, "defaultable" means the single value can be easily set without needing additional input. For example, product with a single TEXT attribute would be single valued but not defaultable, since it's not known what the correct value would be. Similarly, a product requiring a file upload would not be defaultable.

Note that in order to take advantage of defaultable attributes, you need my Default Attribute contribution.