Troubleshooting Unexpected Issues

If something is not working as expected in Iconic Sections, start here. Most issues are resolved by working through the checklist below before contacting support. These steps cover the most common root causes for unexpected behavior.

Step-by-Step Troubleshooting Checklist

Step 1: Refresh the App

Close and reopen the Iconic Sections app in your Shopify admin. A simple refresh resolves many temporary display issues and loading errors within the app interface.

Step 2: Confirm the App Embed Is Enabled

Go to Online Store > Themes > Customize > App Embeds and confirm the Iconic Section toggle is ON and that the theme has been saved after enabling it. This is the most common cause of section display problems.

Step 3: Confirm the Section Is on the Published Theme

Make sure the section is installed on the theme that is currently published (live) on your store. Sections installed on an unpublished draft or development theme will not appear to your store visitors.

To check: in Shopify admin > Online Store > Themes, the active theme is labeled Current theme. Go to My Library and confirm the section is installed there.

Step 4: Clear Your Browser Cache

Your browser may be serving a cached version of your store that does not reflect the latest changes.

Hard-refresh your storefront: press Ctrl+Shift+R (Windows/Chrome) or Cmd+Shift+R (Mac). This forces the browser to load the page fresh from the server.

Step 5: Try a Different Browser

If the issue is visible in the Theme Editor or app interface, open the app in a different browser (for example, switch from Chrome to Firefox or Safari) to rule out a browser-specific conflict. Private/incognito mode in the same browser can also help bypass cache and extension conflicts.

Step 6: Reinstall the Section

If a specific section is behaving unexpectedly:

Go to My Library.
Uninstall the section from the affected theme.
Reinstall it from My Library.
Re-add it to the page in the Theme Editor and save.

A clean reinstall resolves many cases where a section's files became partially corrupted or out of sync during a previous installation.

If the Issue Persists: Contact Support

If none of the above steps resolve the issue, the Iconic Sections support team is ready to help:

Live chat: Click the chat icon in the bottom corner of the Iconic Sections app to start a live chat session
Contact form: arhamwebworks.com/contact

When contacting support, include the following to get a faster resolution:

Your store URL (e.g., yourstore.myshopify.com)
The section name that is causing the issue
A brief description of what you expected to happen and what is actually happening
Any error messages you see (screenshots are helpful)
The theme name you are using

Common Causes the Support Team Investigates

Some issues are caused by factors outside the standard checklist:

Conflicting third-party apps — other apps that modify theme files or inject scripts can occasionally interfere with sections. The support team can help identify conflicts.
Custom theme code — if your theme has been modified by a developer, custom code may affect how sections render.
Browser extensions — ad blockers or privacy extensions can sometimes block section scripts from loading. Disable extensions temporarily to test if this is the cause.

Frequently asked questions

Can conflicting apps cause section issues?

Yes. Some Shopify apps modify theme files, inject scripts, or override stylesheet rules in ways that can conflict with how Iconic Sections renders. If you recently installed another app and a section stopped working correctly, try temporarily disabling the new app to see if the issue resolves. If it does, the support team can help you identify the specific conflict and find a workaround.

How do I report a bug or a broken section?

Contact the support team via the live chat icon inside the app or through arhamwebworks.com/contact. Describe what the section is supposed to do versus what it is doing, and include your store URL and the section name. If possible, include a screenshot or screen recording of the issue — visual context helps the team diagnose and fix problems faster.

What information should I include when contacting support?

The most helpful details are: your store URL, the name of the affected section, a description of the problem (what you see vs. what you expect), the name of your Shopify theme, whether the issue happens on mobile or desktop or both, and any error messages visible in the browser or app. The more context you provide upfront, the faster the support team can identify the cause and provide a resolution.