Storefront pages, URLs and shortcodes
A TitanCart store is mostly made of pages WordPress never sees: the shop, every product and category, the cart, the checkout and My Account are served by TitanCart directly from their URLs. A few features — FAQ, Testimonials, Gift Cards — live on ordinary WordPress pages that TitanCart creates for you, and a set of shortcodes lets you put store content inside pages of your own. This article says which is which, how the URLs are built and what you can change, and which shortcodes work well on a page of your own.
In one sentence: the storefront’s main pages are virtual (no WordPress page exists or is needed, so nothing in Pages can break them), only the product, category and brand URL prefixes are configurable, and every shortcode — the catalogue, orders, wishlist, reviews, FAQ, testimonials, gift cards, and since 0.2.74 the cart, the checkout and My Account too — can be placed on a page of your own.
1. The pages TitanCart serves on its own
These URLs work the moment the plugin is active, with pretty permalinks on (Settings → Permalinks set to anything but Plain; on Plain every store link is a 404 and wp-admin shows administrators a red TitanCart: pretty permalinks required notice with a link to the Permalinks screen). You will not find them under Pages and should not create pages at these addresses.
| Page | URL | Notes |
|---|---|---|
| Shop (all products) | /shop/ |
The prefix is the category prefix (section 2). Shows the product grid with filters and sorting; the first page follows Product list default sorting under Appearance (0.2.78 — earlier versions always served page 1 newest-first whatever the setting), and shows Products per page items, at most 48. The page numbers under the grid show the first and last page and two either side of the current one, with … for the gaps (0.2.81; earlier every page number was listed in one row). |
| Category | /shop/category/ |
Always the flat form: /shop/parent/child/ redirects permanently to /shop/child/. An unknown or disabled category gives a real 404 (your theme’s “not found” page); a hidden category opens by direct link but is listed nowhere. |
| Product | /product/slug/ |
An old slug you changed keeps working through an automatic redirect; an unknown or disabled product gives a real 404 (your theme’s “not found” page); a hidden product opens by direct link but is listed nowhere. |
| Tag | /product-tag/tag/ |
Fixed prefix. An unknown tag gives a real 404 (0.2.77); a tag with a non-Latin name lists its products. |
| Brands and a brand | /brands/, /brands/brand/ |
An unknown or hidden brand gives a real 404. |
| Cart | /cart/ |
Fixed. |
| Checkout | /checkout/ |
Fixed. |
| Order received | /order-received/order number/ |
Shown after checkout; opens for the order’s owner, an administrator, or anyone with the key link from the order e-mail. |
| Invoice, packing slip | /order-invoice/number/, /order-packing-slip/number/ |
Print-ready documents; the packing slip is administrators only. |
| My Account | /my-account/ and /my-account/section/ |
Sections: orders, downloads, wishlist, addresses, profile, groups (Customer Groups, shown when the customer holds a group or one is open to applications), plus rewards, subscriptions, affiliate and vendor sections when those features are on. The orders, wishlist and rewards sections send the customer back to the dashboard when Track orders (Appearance) or that feature is off; a made-up section shows This section is not available. with a link back. Guests see the sign-in / register panel at every address. |
| Search | /search/?q=words |
Fixed. With Search also in pages on (General Settings), up to five matching WordPress pages are listed under the products. |
Unknown addresses answer 404 to HEAD requests as well as to a browser (TitanCart 0.2.75 and later), so uptime monitors and link checkers see the real status, and WordPress’s “guess the nearest post” redirect is switched off for them: /product/foo/ never lands on a blog post called foo. Tags joined in 0.2.77; before that an unknown tag showed an empty tag page.
The wishlist lives inside My Account at /my-account/wishlist/; a stand-alone /wishlist/ page exists only when the Wishlist Plus extension has created it.
2. Changing the URL prefixes
Storefront → SEO has three choices — Product URLs, Category URLs and Brand URLs — each a short list rather than a free text box: products /product/, /p/, /item/ or /goods/; categories (and therefore the shop page) /shop/, /category/, /catalog/, /c/ or /browse/; brands /brands/, /brand/, /manufacturer/ or /b/. Choosing the same prefix for products and categories is refused on Save (Product and category URL prefixes cannot be the same). Saving rebuilds the URL rules by itself — no trip to Settings → Permalinks is needed — but it creates no redirects: links under the old prefix stop working, so choose prefixes before launch or add redirects yourself under Storefront → SEO → URL Redirects. (Renaming a single product or category is different: its old address keeps working through an automatic redirect.) Everything else in the table above is fixed.
3. The WordPress pages TitanCart creates
On activation TitanCart adds five real pages and binds two of them in Settings → Reading:
- Homepage (set as the static front page) and Blog (set as the posts page) — ordinary pages you edit like any other.
- FAQ containing
[titancart_faq], Testimonials containing[titancart_testimonials], and on Pro Gift Cards containing[titancart_gift_cards].
You may rename these pages, change their slug or add text around the shortcode. If one is in the bin or deleted, it comes back the next time an administrator opens wp-admin — so to use a different page for a feature, re-point it instead of deleting (next section). The Shop, Cart, Checkout, My Account, Wishlist, Search Results and Order Received rows that also appear in the page list are the virtual pages of section 1 and are never created as WordPress pages.
4. Storefront → Pages
The Pages page under Storefront lists every storefront surface with its type (Structural, Shortcode or Rewrite) and a status chip: the bound page’s status (Published, Draft, Trash…), Missing when no page exists, or Virtual for the addresses TitanCart serves itself. + Create missing pages rebuilds any feature page that was deleted; the row’s assign control re-points a feature (FAQ, Testimonials, Gift Cards, and the Wishlist page when Wishlist Plus is installed) at any other published page — put the shortcode on that page yourself, TitanCart does not check that it is there. Homepage and Blog are managed in Settings → Reading and the virtual rows cannot be assigned (Handled by rewrite rules — no page needed).
5. Menus and the store header
Appearance → Menus gains two boxes: TitanCart Pages (Shop, Brands, Cart, Checkout, My Account, Search, and Wishlist when that extension is on) and TitanCart Categories (every live category), so store links go into any menu without typing URLs.
With a TitanCart theme (Connecting the theme) the theme’s own header and footer are used everywhere. With any other theme, TitanCart keeps your theme’s header and footer but injects its own store bar (logo, search box, account and cart icons, a menu) and a store footer on the store pages only, and registers four menu locations for them. Until you assign menus there, the bar shows fallback links: a top strip with Shop and Track Order, plus FAQ and Contact when published pages with the slugs faq and contact exist; and footer Company (About, Blog, Contact, Careers) and Support (FAQ, Shipping & Returns) links — again only the ones that exist as published pages; the Company column is left out when none does, while Support always shows at least Privacy Policy and Terms of Service. The footer tagline is your site’s tagline from Settings → General. Assign menus to the four locations, or switch to a TitanCart theme, before launch. The footer’s Privacy, Terms and Refund links follow the pages chosen under Settings → GDPR and General Settings, and fall back to /privacy-policy/, /terms-of-service/ and /refund-policy/ while nothing is chosen.
6. Shortcodes
Shortcodes are for putting store content inside a page of your own; the virtual pages do not use them. Each one renders in your theme’s content area and inherits its typography, and a page that carries any of the core shortcodes in the table below (not the Tips & Donations one) loads TitanCart’s storefront stylesheet and scripts (the cart drawer and add-to-cart work there). Since 0.2.81 that holds however the shortcode got onto the page — typed into the editor, in a Shortcode block, or placed by a page builder that keeps its layout outside the page’s own content — where earlier versions only recognised a shortcode in the page content itself, so a builder page showed the store content without its styles. On such a page the stylesheet is added at the bottom of the HTML, so the content may flash unstyled for an instant on first paint. Some depend on a feature being on: [titancart_wishlist] needs the Wishlist extension and [titancart_reviews] / [titancart_review_form] need Product Reviews — with the feature off they render nothing (0.2.77; earlier versions printed the shortcode text itself on the page) — and [titancart_donation_progress] renders nothing while Tips & Donations is paused. [titancart_gift_cards] joins them in 0.2.78: on Lite, where Gift Cards does not exist, it renders nothing instead of printing the shortcode text (section 9).
| Shortcode | Renders | Attributes |
|---|---|---|
[titancart_shop] |
The product grid, without the shop page’s header area | per_page only (default: Products per page, 24 until you change it; between 1 and 48). The grid shows active products and follows the Appearance default sorting like the shop page (0.2.78; the old status attribute was removed in 0.2.78 because it never did anything). Since 0.2.77 the sort select, filters, view toggle and page buttons work on a page of your own as they do on /shop/. Since 0.2.78 paging behaves like a normal website: the page buttons are real ?tc_page=N links, a click loads the page in place and puts ?tc_page=N in the address bar, the browser’s Back button returns to the previous page, and page N names itself as the canonical address (so a search engine indexes each page once; this needs the SEO extension on with Canonical URLs enabled under Storefront → SEO and no other SEO plugin writing canonicals) — on the shop, category, tag and brand pages as well as on a page of your own. Since 0.2.81 the page numbers are the compact set described in section 1 (first, last, two either side of the current page) after a click as well as on first load. Changing the sort or a filter goes back to page 1 without adding a history entry, and “Load more” or infinite scroll continues from the page you opened. On a page used as the site’s front page the links stay # and the address bar does not change. Before 0.2.78 the address bar never changed and every page pointed its canonical at page 1; before 0.2.77 none of the toolbar worked on a page of your own. |
[titancart_cart] |
The cart, as on /cart/ |
none. Works on a page of your own since 0.2.74 (one header, styled). |
[titancart_checkout] |
The checkout, as on /checkout/ |
none. Since 0.2.74. |
[titancart_account] |
The signed-in customer’s My Account area — dashboard, orders and order detail, addresses, profile, customer groups, and since 0.2.80 wishlist, rewards and downloads — reached through ?tc_account_page=orders and so on; guests see the sign-in and register panel |
none. Since 0.2.74. Since 0.2.81 the page behaves as the account page: the sidebar, the dashboard cards, View on an order, Back to My Orders and the order list’s own paging all keep the customer on your page, and signing in or registering there lands back on your page (before 0.2.81 the first click inside it went to /my-account/, and a sign-in without a return address landed there too). Your page’s own title is used; the store’s My Account banner is not drawn under the shortcode. Sections an extension adds — My Subscriptions, My Raffles, the Affiliate pages, the vendor tools and Licenses — still open at /my-account/, the only address that serves them. |
[titancart_my_orders] |
The customer’s order history, ten per page, with order detail on click | none. Guests see Please log in to view your orders. |
[titancart_wishlist] |
The customer’s wishlist (Wishlist extension on); Wishlist Plus takes it over when installed | none |
[titancart_reviews] |
Published reviews for one product | product_id, per_page, sort (newest, oldest, highest, lowest, helpful), show_heading (1 or 0). See Product reviews. |
[titancart_review_form] |
The review form for one product | product_id |
[titancart_faq] |
The FAQ accordion | category, open_first (1 opens the first entry), schema (0 turns off the FAQ structured data), single (0 lets several entries stay open) |
[titancart_testimonials] |
Customer testimonials | count (12), min_rating, layout (grid) |
[titancart_gift_cards] |
The gift card purchase form (Pro) | none. See Gift Cards. |
[titancart_donation_progress] |
The fundraising progress bar (Tips & Donations extension) | See Tips and donations. |
The cart, checkout and account shortcodes are new to pages of your own in 0.2.74: before that they printed a second header and footer and shipped without their styles, which is why older advice said to avoid them. Linking to /cart/, /checkout/ and /my-account/ is still the simplest route — the Menus box in section 5 does exactly that — and only /my-account/ has the sections extensions add. There is no [titancart_product] shortcode; link to the product’s own URL.
7. Using your own theme’s templates
Every storefront template can be overridden by copying it into your theme: a file at wp-content/themes/your-theme/titancart/product/single.php replaces TitanCart’s templates/product/single.php, and a child theme’s copy wins over the parent’s. The override is picked up without any setting. Keep overrides to a minimum — a template you copied does not receive the fixes in later TitanCart releases. (Unknown products and categories are answered with your theme’s 404 page before any template runs, so an override does not need to handle them.)
8. Blocks, widgets and page builders
TitanCart ships no block-editor blocks and no classic widgets; use the shortcodes above in a Shortcode block. Elementor users get Products and Categories widgets from the separate TitanCart for Elementor extension.
9. TitanCart Lite and Pro
The virtual pages, the SEO prefixes, Storefront → Pages, the Menus boxes and the shortcodes are the same on both editions, with one exception: Gift Cards is a Pro feature, so Lite does not create the Gift Cards page, and a page carrying [titancart_gift_cards] on Lite shows only its surrounding text — since 0.2.78 the shortcode renders nothing there (0.2.77 and earlier printed the shortcode text to visitors), so the page is harmless but pointless; remove it from any page you brought over. See TitanCart Lite.
Troubleshooting
- Every store link gives a 404. Settings → Permalinks is on Plain (wp-admin shows a red pretty permalinks required notice), or the rules are stale. Choose Post name and save; saving that screen rebuilds the rules.
- I deleted the FAQ page and it came back. Expected (section 3). Re-point the feature under Storefront → Pages, or leave the page unpublished-but-present.
- I created a page called “Cart” (or Checkout, My Account, Search, Shop) and nobody can open it. TitanCart’s own page wins at that address, so the WordPress page is unreachable there. Give it another slug.
- The header only shows Shop and Track Order, and the footer is missing its Company column. The fallback bar is showing (section 5) and no published pages with the expected slugs exist. Assign menus in Appearance → Menus, create the pages, or activate a TitanCart theme.
- The product grid shortcode ignores its page buttons. Fixed in 0.2.77 (section 6) — update. On 0.2.74–0.2.76 use
per_pageor?tc_page=; earlier than that, link to the shop. - The address bar stays on page 1 while I page, and Back leaves the shop. That is 0.2.77 and earlier; since 0.2.78 the pager writes
?tc_page=Nto the address bar and Back returns to the previous page (section 6). - The first page of the shop is not in the order I chose under Appearance. Before 0.2.78 page 1 was always newest-first and only the sort select applied the setting; update. Search results are the exception and stay sorted by relevance.
- A page shows
[titancart_wishlist]or another shortcode as plain text. The feature is off or not in your edition. Since 0.2.77 the wishlist and reviews shortcodes render nothing when off, and since 0.2.78 the Gift Cards shortcode renders nothing on Lite (section 9); on an older version remove the shortcode from the page. - Clicking anything inside my account page sends customers to
/my-account/. That is 0.2.80 and earlier; since 0.2.81 the links, the sign-in and the order list’s paging stay on the page (section 6). Only an extension’s sections still open at/my-account/. - The cart, checkout or account shortcode shows without styles on a page-builder page. Before 0.2.81 TitanCart looked for the shortcode in the page’s content only, which a builder that stores its layout elsewhere never fills; update (section 6).
- The shop shows a long row of page numbers. Before 0.2.81 every page was listed and the row grew with the catalogue; since 0.2.81 only the first, last and nearby pages show, and the row wraps on narrow screens (section 1).
- A category or product URL shows “Page not found”. The slug is wrong or the item is disabled. A hidden product or category still opens by its link; a disabled one does not (section 1).
- My uptime monitor reports 404 on a product that was deleted. Correct since 0.2.75: HEAD requests get the real status (section 1). Point the monitor at a live address.
See also
- Connecting the TitanCart theme — the two ways to style the storefront.
- Installing TitanCart — the permalink requirement at install time.
- Categories, tags and filters — the pages behind category and tag URLs.
- Settings overview — where SEO, Appearance and GDPR settings live.
- Managing customers — what customers see in My Account.
- Wishlist Plus — the stand-alone wishlist page.