Understanding the Theme Extension and Theme App Blocks Status 🧩

The BookThatApp (BTA) Dashboard shows two statuses that check how BTA is connected to your Shopify theme: Theme Extension and Theme App Blocks. They check different things, and only one of them affects whether your widgets display.

🔍 The two statuses

Theme Extension (App Embed) checks whether the BTA Booking Widgets app embed is turned on in your theme. It shows one of these:

• Active: the embed is enabled and working.
• Inactive: the embed is not enabled.
• Legacy Version: an older embed version is in use.

⚠️ If the Theme Extension is Inactive, your widgets will not display on your storefront. To fix it, click Activate App Embed on the Dashboard, enable the BTA embed in Shopify, and save your theme.

Theme App Blocks checks whether any BTA app blocks have been added to your theme. It shows one of these:

• Active: one or more BTA app blocks have been added.
• Inactive: no app blocks have been added.

✅ Is an Inactive Theme App Blocks status a problem?

Not necessarily. An Inactive status here only means no app block has been added to your theme. It does not mean something needs updating, and it does not mean your widgets are broken.

App blocks are optional. They let you place a widget in a specific spot using the Shopify theme editor, and they only apply to these widgets:

• Appointment
• Search
• Event Calendar
• Upcoming Events

You can ignore an Inactive Theme App Blocks status if:

• You aren’t using one of the four widgets above.
• You use another widget type, such as Activity/Tour, Classes, Courses, Rentals or Accommodations, which are not supported with app blocks.
• Your widgets already display correctly on your storefront.

It’s worth acting on if:

• You want to place one of the four supported widgets in a specific spot on a page.
• Your Theme Extension is also Inactive or Legacy Version. Fix the Theme Extension first.

To add an app block, see Using App Blocks For Your BookThatApp Widgets.

🛠️ Widget not showing? Check these first

Most issues in this area come from configuration rather than the status wording. Before contacting support, check the following:

1. The Theme Extension is Active. This is the most common cause of widgets not appearing.
2. The widget is assigned to your product. In the widget’s Services tab, make sure All Services is selected, or that your product is selected.
3. You saved the widget. A widget must be saved before an app block can be connected to it.
4. The Widget ID matches. If you added an app block, the Widget ID entered in the theme editor must match the one shown in your BTA widget settings.
5. You haven’t added duplicate app blocks. Use one app block per widget.
6. Your theme is OS 2.0. App blocks aren’t available in older themes. If you don’t see Apps in the block picker, this may be why.

❓ FAQ

Why does my Dashboard say Theme App Blocks is Inactive when my widget is working?
The status only reports whether app blocks have been added. Widgets can still display without them, so an Inactive status doesn’t mean something is wrong.

Do I need to add an app block for every widget?
No. App blocks are optional and only available for the four widgets listed above.

Which status should I pay attention to?
The Theme Extension. If it’s Inactive, widgets won’t display until you enable it.

I’m still stuck. Who do I contact?
Contact support through live chat or at support@bookthatapp.com with your store URL and the widget you’re working with.