Second Category Description: setup and help

Upload the ZIP in Modules > Module Manager > Upload a module. Install it and click Configure. Open Improve > Second Category Description for the dashboard, Templates, and Settings.

Requires PrestaShop 1.6 or later and PHP 7.1 or later.

Installation creates these tables with your database prefix:

mprscd_description
mprscd_description_lang
mprscd_injection
mprscd_profile

Choose the correct shop context, then open Catalog > Categories and edit a category. Fill Second Category Description below the standard description. Enter content for each language you need and save.

On PrestaShop versions before 1.7.7, use the legacy category form to enter the description.

Descriptions are stored for a category and shop, with separate language records. An empty translation does not automatically fall back to the default language. A page with no saved content for its category, language, and shop returns no block.

You can structure content with headings, paragraphs, lists, and links. For example:

<h2>Buying guide for this category</h2>
<p>Explain how to choose between the products in this category.</p>
<h3>What to compare before ordering</h3>
<ul>
  <li>Size or dimensions</li>
  <li>Material or finish</li>
  <li>Compatibility with the rest of the order</li>
</ul>
<h3>Related categories</h3>
<p>Add relevant links to related categories.</p>

Open Second Category Description > Settings > General.

Save your changes. The Template Placement panel links to Open Template Manager and reports whether a tracked injection is active.

Use the category footer hook

Default (inside column) and Full width (CSS breakout) render through displayFooterCategory. Inspect your category template to confirm that hook appears where you want the block.

Full width adds mprscd-fullwidth. It is a CSS breakout and can still be constrained by the surrounding theme layout.

Use template injection

Open Templates and scan the active theme. Review the proposed file and position. Keep a copy of the theme file before changing it, then insert the tracked hook. Select Template injection in Display Mode.

The inserted hook marker is:

{* MPRSCD_INJECT *}{hook h='displayMprSecondCatDesc'}{* /MPRSCD_INJECT *}

You can also place {hook h='displayMprSecondCatDesc'} manually. This custom hook renders only while Display Mode is Template injection. It displays the block at full width.

In injection mode, an active tracked insertion displays the description at the inserted position and hides it from the regular category footer. Without an active tracked insertion, the description can still appear in the category footer. Check for duplicate descriptions if you combine a manual insertion with the regular footer position.

After updating or replacing a theme, check injection status and rescan. The manager can remove tracked insertions.

Open a category with saved content. Check that it appears at the expected footer or injected position. Check another language and, in multishop, another shop context. Open a category with no saved description and confirm no empty block appears.

With First Page Only enabled, open page 2 and verify the block is hidden. The setting uses the page number in the category URL. If your theme uses a different pagination format, check that the block stays hidden on later pages.

The normal wrapper is:

<div class="mprscd-description">
  <div class="mprscd-content">
    <!-- your saved description -->
  </div>
</div>

Full-width mode adds mprscd-fullwidth to the outer class list. Adjust styling in your theme if needed:

.mprscd-description {
  margin-top: 2rem;
  background: #fff;
}
.mprscd-description .mprscd-content {
  line-height: 1.7;
}
.mprscd-description.mprscd-fullwidth .mprscd-content {
  max-width: 1170px;
  margin-left: auto;
  margin-right: auto;
}

If you replace CSS Class, update your CSS selectors accordingly.

Confirm Enable Module is Yes, the category is correct, and the current shop and language have saved content. Check First Page Only before diagnosing a later pagination page.

If content is missing in Default mode, confirm the theme renders displayFooterCategory. If it is missing in Template injection mode, confirm the injected custom hook is present in the active template. The custom hook returns nothing in other display modes or outside category pages.

If content appears twice, check for both a manual hook and an active footer position. Use tracked placement and check the module's injection status after theme changes.

Clear relevant page or template cache after edits. Use the module's Integrity page for required module infrastructure. The dashboard shows how many categories have descriptions.

Descriptions stay in the module and are not copied to the built-in additional category description field. There is no migration tool in the settings.

Use Enable Module = No to hide descriptions without deleting them.

Before uninstalling, export any descriptions you want to keep. Uninstall removes module tables, including saved descriptions, injection records, and profiles. Category deletion also removes the module's corresponding description records.

Uninstall attempts to remove tracked template injections first. If cleanup fails, uninstall can continue and log the failure. Inspect modified theme templates afterward and remove any remaining manual or tracked hook calls if needed.