OpenCart layouts explained: complete guide (2026)

Layouts are the part of OpenCart most store owners meet by accident: you install a module, it does not show up, and the answer turns out to be "assign it to a layout". Once you see the logic, the whole theming system clicks into place.

A layout in OpenCart is a named page type — Home, Category, Product, Checkout, Account, Information — plus the list of modules shown on it and the positions they occupy.

Every OpenCart page is served by a route: product/category for category pages, product/product for product pages, checkout/checkout for the checkout. In the admin under Design → Layouts each layout lists the routes it applies to.

That mapping is the entire trick. When a request comes in, OpenCart looks up the route, finds the layout that claims it, and renders the modules attached to that layout. A page whose route matches no layout falls back to the default one.

Each layout offers four positions: Column Left, Column Right, Content Top and Content Bottom. When you edit a layout you attach modules to a position and give each a sort order — that is the vertical order within the position.

The theme decides how positions look. A two-column theme renders Column Left as a sidebar; a clean one-column theme may render it not at all — which is the classic "I assigned the module and nothing happened" case. If a position stays empty, check whether your theme actually outputs it.

Layouts can target one exact page, not just a page type. A category layout can be overridden for a single category from the category edit screen (Design tab), and the same works for products and information pages. Typical use: a landing-style layout for your best-selling category with banners on top, while every other category keeps the standard grid.

Layouts shape what human visitors see. AI shopping agents — the buyers arriving from ChatGPT and Gemini — do not see your columns at all: they read your structured data, your feeds and your APIs. Check what agents actually see on your store with our free 30-second scan at dreamvention.com/scan.