Configuration ≫ Layout Settings
See also Admin > Catalog > Product Types > Layout Settings for product type specific layout settings.
Column Width - Left Boxes
Key: BOX_WIDTH_LEFT
Path: Configuration > Layout Settings
Description: Width of the Left Column Boxes
px may be included
Default = 150px
Path: Configuration > Layout Settings
Description: Width of the Left Column Boxes
px may be included
Default = 150px
Column Width - Right Boxes
Key: BOX_WIDTH_RIGHT
Path: Configuration > Layout Settings
Description: Width of the Right Column Boxes
px may be included
Default = 150px
Path: Configuration > Layout Settings
Description: Width of the Right Column Boxes
px may be included
Default = 150px
Bread Crumbs Navigation Separator
Key: BREAD_CRUMBS_SEPARATOR
Path: Configuration > Layout Settings
Description: Enter the separator symbol to appear between the Navigation Bread Crumb trail
Note: Include spaces with the symbol if you want them part of the separator.
Default = ::
Path: Configuration > Layout Settings
Description: Enter the separator symbol to appear between the Navigation Bread Crumb trail
Note: Include spaces with the symbol if you want them part of the separator.
Default = ::
Define Breadcrumb Status
Key: DEFINE_BREADCRUMB_STATUS
Path: Configuration > Layout Settings
Description: Enable the Breadcrumb Trail Links?
0= OFF
1= ON
2= Off for Home Page Only
Path: Configuration > Layout Settings
Description: Enable the Breadcrumb Trail Links?
0= OFF
1= ON
2= Off for Home Page Only
Bestsellers - Number Padding
Key: BEST_SELLERS_FILLER
Path: Configuration > Layout Settings
Description: What do you want to Pad the numbers with?
Default =
Path: Configuration > Layout Settings
Description: What do you want to Pad the numbers with?
Default =
Bestsellers - Truncate Product Names
Key: BEST_SELLERS_TRUNCATE
Path: Configuration > Layout Settings
Description: What size do you want to truncate the Product Names?
Default = 35
Path: Configuration > Layout Settings
Description: What size do you want to truncate the Product Names?
Default = 35
Bestsellers - Truncate Product Names followed by ...
Key: BEST_SELLERS_TRUNCATE_MORE
Path: Configuration > Layout Settings
Description: When truncated Product Names follow with ...
Default = true
Path: Configuration > Layout Settings
Description: When truncated Product Names follow with ...
Default = true
Categories Box - Show Specials Link
Key: SHOW_CATEGORIES_BOX_SPECIALS
Path: Configuration > Layout Settings
Description: Show Specials Link in the Categories Box
Path: Configuration > Layout Settings
Description: Show Specials Link in the Categories Box
Categories Box - Show Products New Link
Key: SHOW_CATEGORIES_BOX_PRODUCTS_NEW
Path: Configuration > Layout Settings
Description: Show Products New Link in the Categories Box
Path: Configuration > Layout Settings
Description: Show Products New Link in the Categories Box
Shopping Cart Box Status
Key: SHOW_SHOPPING_CART_BOX_STATUS
Path: Configuration > Layout Settings
Description: Shopping Cart Shows
0= Always
1= Only when full
2= Only when full but not when viewing the Shopping Cart
Path: Configuration > Layout Settings
Description: Shopping Cart Shows
0= Always
1= Only when full
2= Only when full but not when viewing the Shopping Cart
Categories Box - Show Featured Products Link
Key: SHOW_CATEGORIES_BOX_FEATURED_PRODUCTS
Path: Configuration > Layout Settings
Description: Show Featured Products Link in the Categories Box
Path: Configuration > Layout Settings
Description: Show Featured Products Link in the Categories Box
Categories Box - Show Products All Link
Key: SHOW_CATEGORIES_BOX_PRODUCTS_ALL
Path: Configuration > Layout Settings
Description: Show Products All Link in the Categories Box
Path: Configuration > Layout Settings
Description: Show Products All Link in the Categories Box
Column Left Status - Global
Key: COLUMN_LEFT_STATUS
Path: Configuration > Layout Settings
Description: Show Column Left, unless page override exists?
0= Column Left is always off
1= Column Left is on, unless page override
Path: Configuration > Layout Settings
Description: Show Column Left, unless page override exists?
0= Column Left is always off
1= Column Left is on, unless page override
Column Right Status - Global
Key: COLUMN_RIGHT_STATUS
Path: Configuration > Layout Settings
Description: Show Column Right, unless page override exists?
0= Column Right is always off
1= Column Right is on, unless page override
Path: Configuration > Layout Settings
Description: Show Column Right, unless page override exists?
0= Column Right is always off
1= Column Right is on, unless page override
Column Width - Left
Key: COLUMN_WIDTH_LEFT
Path: Configuration > Layout Settings
Description: Width of the Left Column
px may be included
Default = 150px
Path: Configuration > Layout Settings
Description: Width of the Left Column
px may be included
Default = 150px
Column Width - Right
Key: COLUMN_WIDTH_RIGHT
Path: Configuration > Layout Settings
Description: Width of the Right Column
px may be included
Default = 150px
Path: Configuration > Layout Settings
Description: Width of the Right Column
px may be included
Default = 150px
Categories Separator between links Status
Key: SHOW_CATEGORIES_SEPARATOR_LINK
Path: Configuration > Layout Settings
Description: Show Category Separator between Category Names and Links?
0= off
1= on
Path: Configuration > Layout Settings
Description: Show Category Separator between Category Names and Links?
0= off
1= on
Categories Separator between the Category Name and Count
Key: CATEGORIES_SEPARATOR
Path: Configuration > Layout Settings
Description: What separator do you want between the Category name and the count?
Default = ->
Path: Configuration > Layout Settings
Description: What separator do you want between the Category name and the count?
Default = ->
Categories Separator between the Category Name and Sub Categories
Key: CATEGORIES_SEPARATOR_SUBS
Path: Configuration > Layout Settings
Description: What separator do you want between the Category name and Sub Category Name?
Default = |_
Path: Configuration > Layout Settings
Description: What separator do you want between the Category name and Sub Category Name?
Default = |_
Categories Count Prefix
Key: CATEGORIES_COUNT_PREFIX
Path: Configuration > Layout Settings
Description: What do you want to Prefix the count with?
Default= (
Path: Configuration > Layout Settings
Description: What do you want to Prefix the count with?
Default= (
Categories Count Suffix
Key: CATEGORIES_COUNT_SUFFIX
Path: Configuration > Layout Settings
Description: What do you want as a Suffix to the count?
Default= )
Path: Configuration > Layout Settings
Description: What do you want as a Suffix to the count?
Default= )
Categories SubCategories Indent
Key: CATEGORIES_SUBCATEGORIES_INDENT
Path: Configuration > Layout Settings
Description: What do you want to use as the subcategories indent?
Default=
Path: Configuration > Layout Settings
Description: What do you want to use as the subcategories indent?
Default=
Categories with 0 Products Status
Key: CATEGORIES_COUNT_ZERO
Path: Configuration > Layout Settings
Description: Show Category Count for 0 Products?
0= off
1= on
Path: Configuration > Layout Settings
Description: Show Category Count for 0 Products?
0= off
1= on
Shopping Cart - Show Totals
Key: SHOW_TOTALS_IN_CART
Path: Configuration > Layout Settings
Description: Show Totals Above Shopping Cart?
0= off
1= on: Items Weight Amount
2= on: Items Weight Amount, but no weight when 0
3= on: Items Amount
Path: Configuration > Layout Settings
Description: Show Totals Above Shopping Cart?
0= off
1= on: Items Weight Amount
2= on: Items Weight Amount, but no weight when 0
3= on: Items Amount
Customer Greeting - Show on Index Page
Key: SHOW_CUSTOMER_GREETING
Path: Configuration > Layout Settings
Description: Always Show Customer Greeting on Index?
0= off
1= on
Path: Configuration > Layout Settings
Description: Always Show Customer Greeting on Index?
0= off
1= on
Categories - Always Show on Main Page
Key: SHOW_CATEGORIES_ALWAYS
Path: Configuration > Layout Settings
Description: Always Show Categories on Main Page
0= off
1= on
Default category can be set to Top Level or a Specific Top Level
Path: Configuration > Layout Settings
Description: Always Show Categories on Main Page
0= off
1= on
Default category can be set to Top Level or a Specific Top Level
Main Page - Opens with Category
Key: CATEGORIES_START_MAIN
Path: Configuration > Layout Settings
Description: 0= Top Level Categories
Or enter the Category ID#
Note: Sub Categories can also be used Example: 3_10
Path: Configuration > Layout Settings
Description: 0= Top Level Categories
Or enter the Category ID#
Note: Sub Categories can also be used Example: 3_10
Categories - Always Open to Show SubCategories
Key: SHOW_CATEGORIES_SUBCATEGORIES_ALWAYS
Path: Configuration > Layout Settings
Description: Always Show Categories and SubCategories
0= off, just show Top Categories
1= on, Always show Categories and SubCategories when selected
Path: Configuration > Layout Settings
Description: Always Show Categories and SubCategories
0= off, just show Top Categories
1= on, Always show Categories and SubCategories when selected
Banner Display Groups - Header Position 1
Key: SHOW_BANNERS_GROUP_SET1
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Header Position 1?
Leave blank for none
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Header Position 1?
Leave blank for none
Banner Display Groups - Header Position 2
Key: SHOW_BANNERS_GROUP_SET2
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Header Position 2?
Leave blank for none
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Header Position 2?
Leave blank for none
Banner Display Groups - Header Position 3
Key: SHOW_BANNERS_GROUP_SET3
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Header Position 3?
Leave blank for none
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Header Position 3?
Leave blank for none
Banner Display Groups - Footer Position 1
Key: SHOW_BANNERS_GROUP_SET4
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Footer Position 1?
Leave blank for none
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Footer Position 1?
Leave blank for none
Banner Display Groups - Footer Position 2
Key: SHOW_BANNERS_GROUP_SET5
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Footer Position 2?
Leave blank for none
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
What Banner Group(s) do you want to use in the Footer Position 2?
Leave blank for none
Banner Display Groups - Footer Position 3
Key: SHOW_BANNERS_GROUP_SET6
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
Default Group is Wide-Banners
What Banner Group(s) do you want to use in the Footer Position 3?
Leave blank for none
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
Default Group is Wide-Banners
What Banner Group(s) do you want to use in the Footer Position 3?
Leave blank for none
Banner Display Groups - Side Box banner_box
Key: SHOW_BANNERS_GROUP_SET7
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
Default Group is SideBox-Banners
What Banner Group(s) do you want to use in the Side Box - banner_box?
Leave blank for none
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
Default Group is SideBox-Banners
What Banner Group(s) do you want to use in the Side Box - banner_box?
Leave blank for none
Banner Display Groups - Side Box banner_box2
Key: SHOW_BANNERS_GROUP_SET8
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
Default Group is SideBox-Banners
What Banner Group(s) do you want to use in the Side Box - banner_box2?
Leave blank for none
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups
For multiple Banner Groups enter the Banner Group Name separated by a colon :
Example: Wide-Banners:SideBox-Banners
Default Group is SideBox-Banners
What Banner Group(s) do you want to use in the Side Box - banner_box2?
Leave blank for none
Banner Display Group - Side Box banner_box_all
Key: SHOW_BANNERS_GROUP_SET_ALL
Path: Configuration > Layout Settings
Description: The Banner Display Group may only be from one Banner Group for the Banner All sidebox
Default Group is BannersAll
What Banner Group do you want to use in the Side Box - banner_box_all?
Leave blank for none
Path: Configuration > Layout Settings
Description: The Banner Display Group may only be from one Banner Group for the Banner All sidebox
Default Group is BannersAll
What Banner Group do you want to use in the Side Box - banner_box_all?
Leave blank for none
Footer - Show IP Address status
Key: SHOW_FOOTER_IP
Path: Configuration > Layout Settings
Description: Show Customer IP Address in the Footer
0= off
1= on
Should the Customer IP Address show in the footer?
Path: Configuration > Layout Settings
Description: Show Customer IP Address in the Footer
0= off
1= on
Should the Customer IP Address show in the footer?
Product Discount Quantities - Add how many blank discounts?
Key: DISCOUNT_QTY_ADD
Path: Configuration > Layout Settings
Description: How many blank discount quantities should be added for Product Pricing?
Path: Configuration > Layout Settings
Description: How many blank discount quantities should be added for Product Pricing?
Product Discount Quantities - Display how many per row?
Key: DISCOUNT_QUANTITY_PRICES_COLUMN
Path: Configuration > Layout Settings
Description: How many discount quantities should show per row on Product Info Pages?
Path: Configuration > Layout Settings
Description: How many discount quantities should show per row on Product Info Pages?
Categories/Products Display Sort Order
Key: CATEGORIES_PRODUCTS_SORT_ORDER
Path: Configuration > Layout Settings
Description:
1 = Categories/Products: Name
2 = Categories: ID+ / Products: Model
3 = Categories: ID- / Products: Qty+, Name
4 = Categories: Status, Name+ / Products: Qty-, Name
5 = Categories: Status, Name- / Products: Price+, Name
6 = Products: Price-, Name
7 = Products: Model-
8 = Products: Status+
9 = Products: Status-
10 = Products: ID
11 = Products: Weight
Path: Configuration > Layout Settings
Description:
Set the initial sort order for the Admin Category/Product listing page.
0 = Categories/Products: Sort Order, Name1 = Categories/Products: Name
2 = Categories: ID+ / Products: Model
3 = Categories: ID- / Products: Qty+, Name
4 = Categories: Status, Name+ / Products: Qty-, Name
5 = Categories: Status, Name- / Products: Price+, Name
6 = Products: Price-, Name
7 = Products: Model-
8 = Products: Status+
9 = Products: Status-
10 = Products: ID
11 = Products: Weight
Option Names and Values Global Add, Copy and Delete Features Status
Key: OPTION_NAMES_VALUES_GLOBAL_STATUS
Path: Configuration > Layout Settings
Description: Option Names and Values Global Add, Copy and Delete Features Status
0= Hide Features
1= Show Features
(Default=1)
Path: Configuration > Layout Settings
Description: Option Names and Values Global Add, Copy and Delete Features Status
0= Hide Features
1= Show Features
(Default=1)
Category Header Menu ON/OFF
Key: CATEGORIES_TABS_STATUS
Path: Configuration > Layout Settings
Description: Category Header Nav
This enables the display of your store's categories as a menu across the top of your header. There are many potential creative uses for this.
0= Hide Categories Tabs
1= Show Categories Tabs
Path: Configuration > Layout Settings
Description: Category Header Nav
This enables the display of your store's categories as a menu across the top of your header. There are many potential creative uses for this.
0= Hide Categories Tabs
1= Show Categories Tabs
Site Map - include My Account Links?
Key: SHOW_ACCOUNT_LINKS_ON_SITE_MAP
Path: Configuration > Layout Settings
Description: Should the links to My Account show up on the site-map?
Note: Spiders will try to index this page, and likely should not be sent to secure pages, since there is no benefit in indexing a login page.
Default: false
Path: Configuration > Layout Settings
Description: Should the links to My Account show up on the site-map?
Note: Spiders will try to index this page, and likely should not be sent to secure pages, since there is no benefit in indexing a login page.
Default: false
Skip 1-prod Categories
Key: SKIP_SINGLE_PRODUCT_CATEGORIES
Path: Configuration > Layout Settings
Description: Skip single-product categories
If this option is set to True, then if the customer clicks on a link to a category which only contains a single item, then Zen Cart will take them directly to that product-page, rather than present them with another link to click in order to see the product.
Default: True
Path: Configuration > Layout Settings
Description: Skip single-product categories
If this option is set to True, then if the customer clicks on a link to a category which only contains a single item, then Zen Cart will take them directly to that product-page, rather than present them with another link to click in order to see the product.
Default: True
Use split-login page
Key: USE_SPLIT_LOGIN_MODE
Path: Configuration > Layout Settings
Description: The login page can be displayed in two modes: Split or Vertical.
In Split mode, the create-account options are accessed by clicking a button to get to the create-account page. In Vertical mode, the create-account input fields are all displayed inline, below the login field, making one less click for the customer to create their account.
Default: False
Path: Configuration > Layout Settings
Description: The login page can be displayed in two modes: Split or Vertical.
In Split mode, the create-account options are accessed by clicking a button to get to the create-account page. In Vertical mode, the create-account input fields are all displayed inline, below the login field, making one less click for the customer to create their account.
Default: False
CSS Buttons
Key: IMAGE_USE_CSS_BUTTONS
Path: Configuration > Layout Settings
Description: CSS Buttons
Use CSS buttons instead of images (GIF/JPG)?
Button styles must be configured in the stylesheet if you enable this option.
Path: Configuration > Layout Settings
Description: CSS Buttons
Use CSS buttons instead of images (GIF/JPG)?
Button styles must be configured in the stylesheet if you enable this option.
Still have questions? Use the Search box in the upper right, or try the full list of FAQs. If you can't find it there, head over to the
Zen Cart support forum
and ask there in the appropriate subforum.
In your post, please include your Zen Cart and PHP versions, and a link to your site.
Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started.
You can even PR right here.
Last modified February 25, 2024 by Scott Wilson (3f2449d3).