Why does FrontTailor show “Not connected”?

Usually the domain is not granted yet. Check the grant in the popup; on an error click Retry or reload the page.

Why doesn’t FrontTailor detect my UI5 app?

FrontTailor looks for UI5 markers for at most 10 seconds after loading. If the page includes UI5 later, reload the page once the app is there.

Why are the inspector’s editors greyed out?

The host is marked as PROD, in the host profile or by policy. On PROD runtime changes are locked on purpose.

Is there FrontTailor for Firefox?

A Firefox build for Firefox 140 or later is prepared, but submission to Firefox Add-ons is still pending. For now FrontTailor is available for Chrome and Edge.

Troubleshooting

FrontTailor’s most common messages, their cause and what you can do. Texts in italics appear exactly like that in the interface.

Detection: DOM markers, at most 10 seconds
Connected: after a successful ping, then every 5 seconds
Help: GitHub issues or CloudDNA

“Not connected” or “Connecting…” doesn’t go away

The panel shows Connected only after a ping into the UI5 page and back has worked. If it stays at “Not connected” or “Connecting…”, or tabs show “Connect to a UI5 app to use this tab.”:

Check whether the popup shows Activation required – then grant the domain first.
On “Error” in the connection status, click Retry.
Reload the app’s page. FrontTailor connects by itself after loading; panels reconnect by themselves after an interruption.
If you updated the package yourself, reload the extension once under chrome://extensions. Restarting the browser is not enough for that.

“No UI5 app detected”

FrontTailor looks for SAP UI5 markers on every page, such as the bootstrap script sap-ui-core.js, UI areas or the theme link – for at most 10 seconds after loading. After that it waits up to another 10 seconds for sap.ui to be ready.

If the page includes UI5 more than 10 seconds after loading, FrontTailor no longer finds the markers. Then reload the page once the app is there.
On pages without UI5 the icon stays grey – that is correct.
If the app lives in an iframe, see iframes.

Grant required or refused

Message	Cause and fix
“Activation required”, icon blue with !	The domain is not granted yet. Click Activate in the popup and confirm the browser dialog (grant).
“Access was not granted.”	The browser dialog was cancelled. Click Activate again.
“This domain is not allowed by your administrator.”	Your company’s `allowedHosts` policy does not allow the host. Only the policy can change that (Enterprise deployment).

Changes are locked

Editors are grey, or an action ends with “Refused: PROD system – runtime changes are not allowed.” The host is marked as PROD – by your host profile or by the prodHosts policy. That is on purpose: on PROD, live edit, replay, cache reset, overrides and fault simulation are locked (Host profiles and PROD).

If the flag was set by mistake, untick Productive system (PROD) in the popup and click Save profile.
If “Marked as PROD by your administrator.” appears below it, the flag comes from the policy and cannot be changed in the popup.

Module locked or licence rejected

What you see	Cause and fix
Tab with a lock, “… is part of FrontTailor Pro”	The module belongs to a higher edition. Enter a licence key (Licence and editions). During the 7-day trial after installation nothing is locked.
“invalid signature (key changed or incomplete).” or “the licence key cannot be read (incomplete when copied?).”	The key was not copied completely. Paste it again in full from the licence e-mail.
“… issued for another product or key (e.g. iFlow Tailor), not for FrontTailor.”	A key of another product. Use the FrontTailor key.
“the licence does not include the SAP system …. Community applies here.”	The licence is bound to other SAP systems. On the licensed systems the modules are free.
“the licence has expired.”	Renew the licence; until then Community applies.
A tab is missing entirely	Your administrators switched the module off with the `modules` policy. That applies even with a licence.

The side panel won’t open

Chrome opens the side panel only right after a user action. If that doesn’t get through from the command palette or a shortcut, open it with Open side panel in the popup.
Can’t find a tab? In the narrow side panel more tabs are under More. Some views, such as Models, exist only in the DevTools panel (F12 › FrontTailor).
If the palette in the popup shows “Palette not available: no connected UI5 app.”, the tab is not connected – see above.

Apps in iframes

FrontTailor runs in every frame of a page and connects each UI5 frame separately; the connection status shows the number of connected frames. In the inspector’s pick mode, a click on a control in an iframe switches to that frame.

If the app in the iframe is on a different domain than the launchpad, that domain needs a grant, too.
Sandboxed iframes without an origin of their own are supported as well.

The icon is yellow

Yellow with a number means: errors in the UI5 log or failed requests (status 400 or higher) since the page loaded. A $batch with errors in single parts but status 200 does not count here – the OData console shows it (OData console). The latest errors are in the popup and in the Overview tab (Overview & system info). Reloading starts a new session.

Firefox

The same sources produce a Firefox build for Firefox 140 or later, with a sidebar instead of the side panel and without the CPU deep profile; there the cache reset clears the whole HTTP cache, and FrontTailor is activated per site in the popup. Submission to Firefox Add-ons is still pending – for now FrontTailor is available for Chrome and Edge.

More help

If none of this helps, describe the problem with the system info (Overview tab › Copy as Markdown) – as an issue in FrontTailor’s GitHub repository or via the contact form.