Overview

A theme app extension allows merchants to directly integrate a third-party app into a store theme without modifying the original theme code.

Benefits of using theme app extensions​

With theme app extensions, you can achieve the following benefits:

• Visual editing: You can easily add, edit, or remove app components within the theme editor after installing apps that support theme app extensions in the store.
• Bulk deployment: A single release of the theme app extension can apply to all themes using it, streamlining the deployment process.
• Seamless theme updates: Themes leveraging theme app extensions can automatically upgrade alongside SHOPLINE OS 3.0 version themes without modifying the theme code, minimizing the risk of disruptive changes.

Limitations​

There are some limitations on using theme app extensions:

• Theme app extensions cannot be used on checkout pages. This includes all pages initiated by the customer during checkout, such as pages showing shipping methods and order status.
• The following content Sline tags cannot be used:
  • {{#content "header" /}}
  • {{#content "layout" /}}
  • {{#content "footer" /}}
• The section Sline object cannot be used.

Theme app extension resources​

The theme app extension primarily includes the following resources:

• Blocks: App blocks composed of Sline syntax that can be directly injected into themes. The following block types are supported:
  • App Blocks
  • App Embed Blocks
• Public: CSS, JavaScript, and other static app content injected into themes.
• Components: Reusable Sline code snippets that can be used across multiple blocks.

For more details on theme app extension resources, refer to Theme app extension structure.

Next steps​

• Get started building theme app extensions
• Configure the theme app extension structure