App blocks

App blocks let you place (some) LinkSpot elements anywhere in your theme through Shopify's theme editor, beyond the default placement on the product page. The App blocks page lists every block LinkSpot ships and gives you a one-click button to insert each one into your theme.

You can find it in the LinkSpot admin under Settings > Compatibility > App blocks.

A demo of all LinkSpot's app blocks can be seen at https://demo.linkspotapp.com/pages/app-blocks .

What is an app block

An app block is a small piece of UI an app contributes to your theme. You add app blocks through the theme editor the same way you add the theme's own sections and blocks. LinkSpot's app blocks let you place LinkSpot elements at a specific spot in your theme, beyond where they would render automatically.

For most elements you do not need an app block: pins, annotations, badges, and the rest already appear on the product page through the LinkSpot app embed. Use an app block when:

• You want a badge in a section other than the product gallery (for example, in a hero banner).

• You want a collage in a specific spot on the product page instead of replacing a product image.

• You are building a custom layout (such as a landing page) and want a LinkSpot element inside it.

Available app blocks

The page shows five app blocks as cards, each with a preview image, a short description, and an Add to theme editor button:

• Pin. Place interactive pins on product images.

• Annotation. Add explanatory text annotations anywhere on a product image.

• Product Badge. Show contextual badges (new, bestseller, sale, custom) on product images and cards.

• Collage. Build a collage of products, media, and links on any page or section.

• Product Set. Render a curated product set as a button popup, card carousel, or links list.

The Add to theme editor button is gated by plan. If your plan does not include app blocks, the button is locked and a tooltip tells you which plan is required to unlock them.

How to add an app block to your theme

1. Find the card for the block you want to add.

2. Click Add to theme editor. A popup opens the Shopify theme editor on the product template with the selected app block ready to be added in a new Apps section.

3. The theme editor places the block where Shopify allows. You can drag it to a different section or template once it is added.

4. Configure the block's own settings from the theme editor sidebar (which element to show, alignment, and other options depending on the block).

5. Click Save in the theme editor.

If your browser blocks the popup, allow popups for the LinkSpot domain and try again.

Where blocks appear

Once added through the theme editor, an app block renders on every page that uses the section it lives in. For example, a Product Badge block added to the product template appears on every product page that uses that template. A Pin block added to a custom page section appears only on that page.

You configure the elements (pins, badges, etc.) themselves from the Elements section of the LinkSpot admin. The App blocks page only handles inserting the block into the theme; the data the block displays comes from your element configurations.