> For the complete documentation index, see [llms.txt](https://flicky.gitbook.io/flicky-announcement-bars/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://flicky.gitbook.io/flicky-announcement-bars/faq.md). # FAQ Frequently asked questions about **Flicky Announcement Bar**. Each answer stands on its own — jump to whichever question matches what you need. For anything not covered here, email ****. ## Getting started ### How do I install Flicky Announcement Bar? Install Flicky Announcement Bar from the Shopify App Store. Installation uses Shopify's managed flow, so Shopify handles setup and permissions — there is no separate login. After installing, open the app from your Shopify Admin to create your first bar. ### How do I show a bar on my storefront? Two steps are required for a global bar. First, create and **publish** a bar in the app (set its status to active). Second, enable the app on your theme so bars can render: in your Shopify Admin go to **Online Store → Themes → Customize → App embeds**, then turn on **Flicky Announcement Bar**. Once the app embed is on and a bar is active and matches your targeting, the bar appears on your storefront. ### How do I create my first bar? Open Flicky Announcement Bar from your Shopify Admin and click **Create banner**. Choose a bar type (announcement, marquee, or carousel), enter your message and an optional button, adjust the design, and set placement, schedule, and targeting. Use the live preview to check how it looks, then set the bar's status to active to publish it. ## Bar types ### What types of bars can I create? Flicky Announcement Bar currently supports three bar types: **Announcement** (a single message with an optional call-to-action button), **Marquee** (text that scrolls horizontally across the bar), and **Carousel** (several messages that rotate in sequence). You can create as many bars as you like at no cost. ### Do you support countdown timers, free-shipping goals, or discount-code bars? Countdown timers, free-shipping progress bars, and discount-code bars are on the roadmap and are **not available yet**. Today you can build announcement, marquee, and carousel bars. Watch the app for updates as these types are released. ### Can I show multiple messages in one bar? Yes. Use a **Carousel** bar to rotate through several messages (slides), each with its own text and optional button, on a timed interval. Use a **Marquee** bar if you want a continuous scrolling ticker instead of discrete rotating slides. ## Placement and position ### What is the difference between an App Embed bar and an App Block bar? An **App Embed** bar (position **Auto**) is injected across your storefront automatically once you enable the app embed in your theme — ideal for a site-wide bar at the top of every page. An **App Block** bar (position **Block**) is one you place yourself into a specific theme section (for example a homepage or product section) by adding the app block and picking which published bar to show there. ### How do I add a bar inside a specific section (App Block)? Set the bar's position to **Block** and publish it. Then, in **Online Store → Themes → Customize**, open the section where you want the bar, choose **Add block → Apps → Flicky Announcement Bar**, and select your published bar in the block's settings. The bar renders at that exact spot in the section. ### Can I make a bar sticky so it stays visible while scrolling? Yes. For a global (Auto) bar, enable the **sticky** option. A sticky bar stays fixed to the top of the viewport as the visitor scrolls, so your message remains visible. ## Design and styling ### What can I customize on a bar? You can set the **background** and **text** colors, **content alignment**, **bar height**, **font** (theme font or a **Google Font**), and **font size**. When your bar includes a button, you can also style the button's color, text color, border, and corner radius. Carousel arrows and the close (×) button color can be adjusted as well. ### Can I use custom fonts? Yes. Choose a **Google Font** for a bar and the storefront loads that font automatically. If you prefer, keep the theme's own font so the bar matches your store's typography. ### Will bars match my theme and look good on mobile? Bars are rendered through your theme and are responsive, so they adapt to mobile screens. Use the live preview in the editor to switch between desktop and mobile and confirm the appearance before publishing. ## Targeting ### Can I control who sees a bar? Yes. Each bar has targeting rules across four groups: **Pages** (for example home, product, collection, cart), **Devices** (desktop and mobile), **Customer** (logged-in vs. guest, customer tag, or a specific customer), and **Country**. A bar shows only when **all** of its rules match (they combine with AND), so you can be as specific as you need. ### Why does the app ask for access to customers? The `read_customers` permission is used only so you can target bars by customer state (logged-in vs. guest), customer tag, or a specific customer. The app reads this data at display time to decide whether a bar should show; it does not copy or store your customers' personal data. See the [Privacy Policy](/flicky-announcement-bars/privacy-policy.md) for details. ### Can I target specific products or collections? Yes. Add a **Pages** targeting rule for specific products or collections using the resource picker. The bar then shows only on the product or collection pages you selected. ## Scheduling ### Can I schedule a bar to run only during a sale? Yes. Set a **start** and **end** date on the bar. Flicky Announcement Bar automatically moves the bar from scheduled to active when the start date arrives, and expires it after the end date — no manual switching required. ### What happens when a scheduled bar's end date passes? When the end date passes, the app automatically transitions the bar to **expired** and stops showing it on your storefront. You can edit the schedule or reactivate the bar at any time. ## Behavior ### Can visitors close a bar? Yes, if you make the bar **dismissible**. When a visitor closes a dismissible bar, it stays hidden for the rest of that browsing session and reappears in a new session. The dismiss state is stored only in the visitor's own browser. ## Pricing ### How much does Flicky Announcement Bar cost? Flicky Announcement Bar is **100% free**. All features are available to every store — there are no paid tiers and no feature gating. To keep the service sustainable, very high fair-use limits protect the infrastructure, but ordinary stores never reach them. ## Performance ### Will Flicky Announcement Bar slow down my store or cause layout shift? No. Bars are rendered **server-side** through your theme, with critical styles inlined, so they appear immediately without a flash or cumulative layout shift (CLS). The app is built to meet Shopify's performance expectations for storefront apps. ## Privacy and data ### What data does the app collect about my visitors? Very little. Flicky Announcement Bar does not run visitor analytics or tracking, and it does not store your customers' personal data. The only storefront storage is a small first-party flag that remembers when a visitor dismissed a bar. Full details are in the [Privacy Policy](/flicky-announcement-bars/privacy-policy.md). ### Do you track clicks, impressions, or conversions? Bar analytics (impressions, clicks, and conversions) are on the roadmap and are **not collected today**. When analytics are introduced, they will be described in the app and in the [Privacy Policy](/flicky-announcement-bars/privacy-policy.md). ## Troubleshooting ### My bar isn't showing on the storefront — what should I check? Check three things, in order. First, make sure the app embed is enabled: **Online Store → Themes → Customize → App embeds → Flicky Announcement Bar** must be on. Second, confirm the bar's status is **active** (a draft or paused bar does not render). Third, review the bar's targeting and schedule — if a targeting rule excludes the page, device, customer, or country you are testing, or the schedule window has not started, the bar stays hidden. ### My App Block bar isn't showing — what's different? An App Block bar only appears where you place it. In **Online Store → Themes → Customize**, open the target section, make sure you added the **Flicky Announcement Bar** app block, and confirm you selected a **published** bar in the block's settings. If the selected bar is paused or in draft, the block renders nothing. ### The bar overlaps my theme's header or another element — how do I fix it? Turn off **sticky** if you do not need the bar pinned while scrolling, or move the bar to the bottom or into a specific section using an App Block so it sits in a fixed spot in your layout. Adjust the bar height and alignment to fit the space around your header. ### The live preview doesn't match my storefront — why? The live preview updates in real time as you edit and mirrors the storefront rendering. If your published storefront looks different, re-check that you saved and set the bar to active, and that the app embed is enabled on the theme you are viewing. Changes to a draft are visible only in the preview until the bar is published. ## Uninstall and data deletion ### What happens to my data if I uninstall the app? When you uninstall Flicky Announcement Bar, the app deactivates your store record and removes the stored Shopify sessions/tokens for your store, and your bars stop rendering. About 48 hours after uninstall, Shopify sends a shop-redaction request and the remaining store data for your shop is removed. Because the app does not store your customers' personal data, there is no customer data to delete. See the [Privacy Policy](/flicky-announcement-bars/privacy-policy.md) for the full data-retention details. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://flicky.gitbook.io/flicky-announcement-bars/faq.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.