Install Firefly Core and article blocks

Firefly uses one app embed for shared storefront behavior and five optional article blocks for visible article features. The five blocks are not additional app embeds, and you do not need to install all of them.

What is available

• Firefly Sky SEO AI Blog — the single Firefly Core app embed. Enable it once for the store.
• Article information — publication date, author, category, word count, and reading time.
• Author profile — a configurable author card.
• Article summary — a custom or generated summary with optional reader feedback.
• Social sharing — Facebook, X, and email sharing based on the article’s canonical URL.
• Article seasonal ambience — optional snow, fireflies, or falling leaves on article pages.

Before you start

• Confirm that the active theme is the theme you want to change.
• Keep at least one Shopify blog article available. Firefly uses a real article as the theme-editor preview when possible.
• If you are editing a duplicated or unpublished theme, open that theme’s editor directly and verify its name before saving.

Enable the single Firefly Core app embed

1. In Shopify Admin, open Apps → Firefly Sky SEO AI Blog → Blog sections.
2. In One app embed, choose the action to enable Firefly Core.
3. Shopify opens the theme editor for a blog article template and highlights the Firefly app embed.
4. Turn on Firefly Sky SEO AI Blog.
5. Review Add Firefly Article structured data. Leave it off if your theme or another app already outputs Article or BlogPosting JSON-LD.
6. Preview a blog article, then choose Shopify’s Save button.

Enable Firefly Core once. Do not look for or add a second Firefly app embed for the optional article features.

Add an optional article block

1. Return to Blog sections in Firefly.
2. Choose the block you want and select Add to Default blog post — then save.
3. The deep link opens the active theme’s Default blog post template when Shopify accepts the requested template context. It also asks Shopify to add that specific Firefly block as a new, unsaved app section.
4. Confirm that the theme name and Default blog post template shown at the top of the editor are correct.
5. Move the block to the desired position and configure its settings.
6. Preview desktop and mobile.
7. Choose Shopify’s Save button.

The automatically added block is only an unsaved preview until step 7. Closing the editor, leaving the page, or choosing Discard means the storefront is not changed.

The enabled Save button confirms that the newly added app section is still an unsaved theme change. The screenshot uses a development theme and neutral preview content; no merchant identity is shown.

If Shopify offers “Restore last session”

For a fresh Firefly installation, do not restore the earlier session. Shopify may show a Restore last session notice when an earlier theme-editor session ended with unsaved changes. Choosing Restore can replace the Default blog post context and unsaved block state requested by the new Firefly deep link.

For the clearest installation flow:

1. Dismiss the restore notice with its close control before configuring the newly requested Firefly block.
2. Confirm that the top bar still shows Default blog post.
3. If the requested block is no longer present, return to Firefly and choose Add to Default blog post — then save again.
4. Configure the block and choose Shopify’s Save button.

Choose Restore only when you intentionally want to recover the earlier unsaved theme changes. Finish, save, or discard that recovered work first; then return to Firefly and start the block installation again.

If the wrong template opens

1. Use the template selector at the top of Shopify’s theme editor and choose Blog posts → Default blog post.
2. Under Template, choose Add section → Apps.
3. Select the intended Firefly block.
4. If the block is already present, select and configure the existing section instead of adding a duplicate.
5. Preview an article and save the theme.

If the deep link repeatedly opens the home page, verify that the store has a blog article with a valid handle, then reopen the action from Blog sections.

Remove an optional block

Open the affected blog post template, select the Firefly block, choose Remove section, and save the theme. Removing an optional block does not disable Firefly Core and does not delete Shopify articles.