Install and enable

Install the app from the Shopify App Store, then enable the app embed in your theme so widgets can render on the storefront. After install, the home page surfaces a “Setup guide” card that walks you through the 4 onboarding steps.

Step 1 — Install from the App Store

Find TT Badges & Product Labels on the Shopify App Store and click Add app → confirm permissions in your admin.

Image: TT Badges & Product Labels on the Shopify App Store (with the Install / Add app button).

Permissions requested:

• read_locales — read the languages enabled on your store
• read_themes — read theme files (used to derive color schemes)
• write_products — read products / collections / variants metafields, write widget config metafields
• read_inventory — read inventory (used by the inventory visibility dimension)
• unauthenticated_read_product_listings / unauthenticated_read_product_inventory — Storefront API (used when the Label widget renders on collection pages)

The app does not request access to customer personal data, orders, or payment information. See Privacy Policy.

Step 2 — Enable the app embed

Step 1 of the home “Setup guide”: “Enable app embed in your Shopify theme”.

Tip: “Enable the TT Badges & Product Labels app embed so widgets can render on your storefront.”

Shopify Admin
  → Online Store → Themes
  → Current theme → Customize
  → Theme editor bottom-left → App embeds
  → Toggle "TT Badges & Product Labels app embed" ON
  → Click Save

Image: theme editor → App embeds panel → toggle TT Badges & Product Labels app embed → Save.

⚠️ Note: “Switching themes resets this toggle — you’ll need to re-enable it after changing themes.”

Step 3 — Verify

Back on the tt-blocks admin home, the “App status” card in StatsRow should read “Enabled”.

If it still shows “Disabled”:

• Wait a few seconds and refresh (Shopify metafield sync has latency)
• Confirm you actually clicked Save in the theme editor (not just toggled the switch)
• Confirm you edited the published theme (not a draft theme)

Image: home page “App status” card in “Disabled” vs “Enabled” states side-by-side.

Step 4 — Create your first widget

The setup guide then walks you through:

• “Create your first widget” — see Quick start
• “Add the widget block to your product page template” — Custom Position scenario, see Custom placement
• “Verify on your storefront”

Uninstall

To uninstall:

Shopify Admin
  → Settings → Apps and sales channels
  → TT Badges & Product Labels → ⋯ → Uninstall

After uninstall:

• Shopify automatically fires the app/uninstalled webhook
• Merchant widget data is deleted per Privacy Policy §6
• The tt-blocks app embed in your theme is deactivated automatically (widgets no longer render on the storefront)

Multi-store / development stores

• Each Shopify store installs and is billed independently
• You can install on a Shopify development store for testing (free demo mode)