> For the complete documentation index, see [llms.txt](https://docs.samita.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samita.io/help/faq.md).

# FAQ

Answers to the questions merchants ask most about Sami Product Labels.

## Plans and limits

<details>

<summary>How many badges can I create?</summary>

It depends on your plan. **FREE** allows up to **5 badges**; **GOLD** and **DIAMOND** allow unlimited badges.

Deleted badges still count toward the FREE limit. See [Pricing plans](/settings/pricing-plans.md) for the full comparison.

</details>

<details>

<summary>What happens to my badges if I downgrade?</summary>

Badges that rely on features your new plan doesn't include stop displaying, but nothing is deleted. Upgrade again and they reactivate with their settings intact.

</details>

<details>

<summary>How do I apply a discount code?</summary>

Open **Pricing plans**, click **Have a discount code?** beside the **Choose your plan** heading, enter your code in the **Apply Discount Code** dialog, and click **Apply**. Do this before you select a plan so the reduced price is used.

</details>

## Targeting and display

<details>

<summary>Can I show different badges for different countries?</summary>

Yes, on **GOLD** and above. Set a country restriction in the badge's display conditions so it only shows to visitors from the countries you choose.

See [Target by country and language](/badges-and-labels/target-by-country-language.md).

</details>

<details>

<summary>Can I show a countdown timer on my badge?</summary>

Yes, on **GOLD** and above. Insert the `{countdown}` variable into a text badge, then set the end date under **Display > Visibility Date & Countdown**.

See [Use dynamic variables](/badges-and-labels/dynamic-variables.md) and [Schedule badge visibility](/badges-and-labels/schedule-visibility.md).

</details>

<details>

<summary>Can I use the app with a page builder like PageFly?</summary>

Yes — PageFly, GemPages, Shogun, and similar builders all work. You may need to adjust the page conditions in the badge's **Display** tab so badges appear on the pages the builder generates.

</details>

## Images and content

<details>

<summary>What image formats can I upload?</summary>

PNG, JPG, and SVG, up to **5 MB**. The recommended size is **512 × 512 px**. The app shows these requirements beneath the image field in the editor.

</details>

<details>

<summary>Can I move badges between stores?</summary>

Not directly — there is no export or import action, so badges cannot be transferred between stores. Within a single store, use **Duplicate** to copy a badge.

See [Duplicate and manage badges](/badges-and-labels/duplicate-badges.md).

</details>

## Shopify Sidekick

<details>

<summary>Can I use Shopify Sidekick with Sami Product Labels?</summary>

Yes, on every plan, with nothing to install. Click **Work with Sidekick** at the bottom of your Shopify admin, allow Sidekick to use **Sami Product Labels** when it asks, and ask about your badges, badge groups, banners, discounts, or badge performance. See [Shopify Sidekick](/integrations/shopify-sidekick.md).

</details>

<details>

<summary>Can Sidekick change my badges?</summary>

No. Sidekick only reads your app data. When you ask it to create a text badge, it opens the badge editor already filled in, and the badge is created only when you click **Save**. See [Draft a text badge with Sidekick](/integrations/sidekick-draft-badge.md).

</details>

## Performance

<details>

<summary>Will the app slow down my store?</summary>

No. The app uses Shopify's App Embed and delivers badge data through metafields, so badges load as part of your theme without extra API calls or external scripts.

</details>

## Next steps

* [Troubleshooting](/help/troubleshooting.md) — fix the most common display problems.
* [Contact support](/help/contact-support.md) — reach the team directly.

{% hint style="success" %}
**Need support?**

If you run into any difficulty, contact us at <support@samita.io>.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.samita.io/help/faq.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.