Updating Templates and TBBs following an upgrade

If you are using the legacy, template-based publishing model, the upgrade process may require updating existing Templates and TBBs (Template Building Blocks).

About this task

This task applies only when using the template-based publishing model. As of SDL Tridion Sites 9.5, the template-based publishing framework is considered legacy in favor of templateless, data-only publishing.

Following an upgrade to Tridion Sites 9.6, you need to update existing Templates and TBBs in the following two situations:

  • You have TBBs that reference the dropped Context Expressions extension.
  • You are using Experience Manager and migrating from the deprecated publishing framework that uses Publication Targets (defined in Content Manager) to the newer, preferred publishing framework that uses Topology Manager.

Procedure

  1. For each TBB that is in use, do the following:
    1. Open the TBB in an editor.
    2. Check for and remove all references to the following TBB: Tridion.Extensions.ContextExpressions.Templates
  2. If you are migrating your Experience Manager Templates to the publishing framework that uses Topology Manager, do the following:
    1. From the Windows menu, select Start > RWS Group > Template Builder to launch Template Builder.
    2. Select Tools > Create Default Building Blocks to show the new default Template Building Blocks in an area labeled Default Building Blocks.
    3. From Template Builder, open all Component Templates and Page Templates used for Experience Manager; that is, all Component Templates that contain the Template Building Block called Enable Inline Editing for Content, and all Page Templates that contain the Template Building Blocks called Enable Inline Editing for Page.
    4. For each Component Template that you opened, drag Enable Inline Editing for Content from the new Default Building Blocks area to directly below the existing Enable Inline Editing for Content. Then remove the original Template Building Block.
    5. For each Component Template that you opened, drag Enable Inline Editing for Page from the new Default Building Blocks area to directly below the existing Enable Inline Editing for Page. Then remove the original Template Building Block.