# tt-blocks Docs

> tt-blocks is a no-code visual widget app for Shopify merchants — badges, buttons, coupons, brand icons, product labels, and more. This file is the LLM-friendly index of all documentation pages.

## Documentation pages

- [TT Badges & Product Labels](https://docs.tantou.ai/tt-blocks/): A no-code visual block app for Shopify merchants — badges, buttons, coupons, brand icons, product labels, and more.
- [Changelog](https://docs.tantou.ai/tt-blocks/changelog/): TT Badges & Product Labels version history.
- [Badge](https://docs.tantou.ai/tt-blocks/components/badge/): Single badge component with icon / shape / popover.
- [Badge list](https://docs.tantou.ai/tt-blocks/components/badges/): Multi-badge container component, displays badges in a row.
- [Brand icon (item)](https://docs.tantou.ai/tt-blocks/components/brand-icon/): Single brand icon item (type: brand_icon), used as a child of brand icon container.
- [Brand icons](https://docs.tantou.ai/tt-blocks/components/brand-icons/): Brand icon container component, displays multiple brand logos in a row.
- [Button](https://docs.tantou.ai/tt-blocks/components/button/): Single-button component (type: button) — presets, link, styling.
- [Button list](https://docs.tantou.ai/tt-blocks/components/button-list/): Multi-button container component, displays buttons in a row.
- [Coupon](https://docs.tantou.ai/tt-blocks/components/coupon/): Display a copyable coupon code with label + discount code + expiration.
- [Group](https://docs.tantou.ai/tt-blocks/components/group/): Generic grouping container (type: group).
- [Heading](https://docs.tantou.ai/tt-blocks/components/heading/): Heading text component.
- [Label chip](https://docs.tantou.ai/tt-blocks/components/label-chip/): Label component (type: label_chip), for use inside label-type blocks.
- [Payment icons](https://docs.tantou.ai/tt-blocks/components/payment-icons/): Payment method icons group, supports manual selection or dynamic auto-detection from Shopify enabled payment methods.
- [Text](https://docs.tantou.ai/tt-blocks/components/text/): Free-form text component.
- [Block types](https://docs.tantou.ai/tt-blocks/concepts/widget-types/): Three block types (Complex / Floating / Label) — what each is for and why type is locked after creation.
- [Block list](https://docs.tantou.ai/tt-blocks/dashboard/): Grid / list views, statistics, bulk actions, setup guide.
- [Content tab](https://docs.tantou.ai/tt-blocks/editor/content/): Edit the block's component tree and fields; layered drill-in by component type.
- [Advanced tab](https://docs.tantou.ai/tt-blocks/editor/design/): Color scheme, custom CSS, and delete actions for a block.
- [Target tab](https://docs.tantou.ai/tt-blocks/editor/display/): Control where the block is shown. 8 independent visibility dimensions, ALL must match.
- [Languages tab](https://docs.tantou.ai/tt-blocks/editor/localization/): Provide translations for shop's enabled locales.
- [Editor overview](https://docs.tantou.ai/tt-blocks/editor/overview/): The block editor's overall layout — 4 tabs + live preview + desktop / mobile toggle.
- [FAQ](https://docs.tantou.ai/tt-blocks/faq/): Quick answers — for full procedures, follow the links to the canonical pages.
- [Install and enable](https://docs.tantou.ai/tt-blocks/getting-started/install/): Install TT Badges & Product Labels from the Shopify App Store and enable the theme app embed.
- [Quick start](https://docs.tantou.ai/tt-blocks/getting-started/quick-start/): 10 minutes through all the basics — create, edit, set display rules, translate, publish, verify.
- [Quick start (Product image overlay)](https://docs.tantou.ai/tt-blocks/getting-started/quick-start-label/): 10-minute walk through the Label block — pick placement, choose preset, edit chip, set scope, publish, verify on PDP and collection page.
- [Make coupon work](https://docs.tantou.ai/tt-blocks/how-to/coupon-setup/): Create discount in Shopify Admin → paste into Coupon component → click auto-copies and applies at checkout.
- [Embed block at any theme location](https://docs.tantou.ai/tt-blocks/how-to/custom-placement/): Custom Position flow — copy ID → theme editor → add app block.
- [Reuse block across multiple positions](https://docs.tantou.ai/tt-blocks/how-to/duplicate-widget/): Duplicate existing block → change placement / display rules → publish independently.
- [Apply theme colors to blocks](https://docs.tantou.ai/tt-blocks/how-to/import-theme-colors/): Use your published theme's colors as a color scheme on your blocks.
- [Schedule a campaign on / off](https://docs.tantou.ai/tt-blocks/how-to/schedule-campaign/): Use the Schedule dimension to auto-launch and auto-end blocks for holiday or limited-time promotions.
- [Translate block text for multi-language stores](https://docs.tantou.ai/tt-blocks/how-to/translate-widget/): Languages tab actual workflow.
- [Show different blocks by traffic source (UTM)](https://docs.tantou.ai/tt-blocks/how-to/utm-targeting/): Show different blocks to TikTok / Email / Google visitors (Pro feature).
- [Legal](https://docs.tantou.ai/tt-blocks/legal/): Legal documents for TT Badges & Product Labels.
- [Data Processing Agreement](https://docs.tantou.ai/tt-blocks/legal/dpa/): GDPR-compliant DPA between merchant (Controller) and TT Badges & Product Labels (Processor).
- [Privacy Policy](https://docs.tantou.ai/tt-blocks/legal/privacy/): How TT Badges & Product Labels collects, uses, and protects information.
- [Refund and Subscription Policy](https://docs.tantou.ai/tt-blocks/legal/refund/): Subscription, billing, refund, and cancellation terms for TT Badges & Product Labels.
- [Terms of Service](https://docs.tantou.ai/tt-blocks/legal/terms/): Terms governing merchant use of TT Badges & Product Labels.
- [Plans and pricing](https://docs.tantou.ai/tt-blocks/plans/): What you get on Free vs Pro, demo quotas, and how upgrades and downgrades work.
- [Reference](https://docs.tantou.ai/tt-blocks/reference/): Fill kinds, icon library, animations, anchors, font weights, and more.
- [Placement reference and custom anchors](https://docs.tantou.ai/tt-blocks/reference/anchors-cascade/): The 7 placement cards in the editor, plus custom CSS selectors when your theme isn't auto-detected.
- [Placement modes — auto vs manual](https://docs.tantou.ai/tt-blocks/reference/placement-modes/): Two ways to place a block on your storefront and when to choose each.
- [Settings](https://docs.tantou.ai/tt-blocks/settings/): Admin UI language and subscription billing.
- [Storefront behavior](https://docs.tantou.ai/tt-blocks/storefront/): How blocks behave on the customer-facing storefront — responsive, coupon click, popover, multi-language, SEO, analytics.
- [Troubleshooting](https://docs.tantou.ai/tt-blocks/troubleshooting/): Diagnose blocks that don't show on the storefront, plus limits and common errors.
- [Block creation wizard](https://docs.tantou.ai/tt-blocks/wizard/): Three-step flow — placement, template, color scheme.

## Full content

For the complete markdown of every page in a single file, see https://docs.tantou.ai/llms-full.txt.

Each page is also available as raw markdown by appending `.md` to its URL — e.g. https://docs.tantou.ai/tt-blocks/getting-started/install.md