Troubleshooting guides

In this page you will find solutions to common issues.

Mandatory Update to Elements Publish

Deadline: February 1st, 2026

This update is required due to Atlassian’s deprecation of the Confluence Cloud REST API (Convert content body v1), scheduled for February 1st, 2026.
To ensure a smooth transition, we strongly recommend completing this update as soon as possible.

How to Apply the Update (Jira Administrators)

Go to Jira → Apps → Elements Publish
A mandatory update message will be displayed
Click the “Update my recipes” button (this is a one-click action)
Keep the page open until the update is fully completed

Known Issues

Recipes using Elements Publish for Child Issues in Confluence Templates

After completing the update, you may encounter an issue if your recipes include Elements Publish for Child Issues embedded in Confluence templates. This known issue is related to the API changes and affects a limited number of configurations. Even after applying the mandatory update, recipes using Elements Publish for Child Issues in Confluence templates will not function correctly for the moment. When attempting to execute a recipe containing these macros, the Confluence page will not be created. Instead, users will see the following error message:

Current Status :

Elements Publish for Child Issues macro has been temporarily suspended : existing macros cannot be edited and new macros cannot be created (note : this is only for templates, child macros can be used in editor without issues).

Administrators trying to set up this feature will see the following message displayed :

Available Workarounds to help you continue using the app effectively:

Remove child macros from recipe configuration
If you need to publish pages now using the affected templates, you can edit your recipe and temporarily remove child macros from the configuration. This will allow the page to be published without errors.
Use Child Issues in the Confluence editor instead
Recipes using Child Issues directly in the Confluence editor (not inside a template) are working as expected. You can continue publishing pages this way without issues.
Postpone page creation for templates using Child Issues
If your recipe uses Child Issues inside a Confluence template and keeping them is very important, we recommend postponing page creation until the issue is resolved.

Our development team is actively working on a fix. We will update this section with a resolution and any required steps as soon as the fix is deployed.

Error message on Elements Publish app install

Scenario

You look for a new app by selecting Find new apps from the Apps menu:

Having found an app, you press the Try it free button:

In the popup, you attempt to start a free trial by pressing the Start free trial button

An attempt is made to install the app:

Adding [App Name]… We’ll tell you when your app has been added.

Then a generic error message is displayed:

*“We ran into a little trouble. It might be a hiccup. Try again in a bit.”*

Troubleshooting

This rather generic error message can be displayed for a number of reasons.

Here are some of the reasons we currently know about:

1/ You have an inactive subscription for this app

If you’ve previously had a trial of this app which expired, then uninstalled and reinstalled the app, this error message may appear.

Check your subscriptions

In Jira administration, select Billing from the menu

In Billing Preview, select the product you are using, e.g. Jira, and press the Manage link:

Scroll down and look for Inactive Subscriptions.

If the app is present there, then the only way to get it working again is to contact Atlassian’s customer support. Press the contact customer support link to discuss the issue with Atlassian

2/ You have an outstanding quote with Atlassian

Browse to https://my.atlassian.com/billing/quotes and check whether you have any outstanding quotes with Atlassian.

3/ Atlassian have no current payment details for you

There is no credit card on your account
Your credit card has expired

In Jira administration, select Billing from the menu:

In Billing Preview, select the product you are using, e.g. Jira, and press the Manage link:

If there is a problem with your credit card, you will see the We need your payment details box:

Click on the Add payment details link and update your details.

4/ The app you are installing has the same alias as an existing app on your Confluence instance

If 2 apps have the same macro aliases, then this error will potentially also be displayed.

Atlassian have documented what is supposed to happen here: https://community.developer.atlassian.com/t/prevent-connect-apps-with-macro-alias-conflicts-from-installing/45690

5/ Restore from backup was done, displacing the default application access group

After a Restore from backup is done on an instance, an incorrect default application access group may be present on your cloud instance. Due to this, apps/plugins are unable to identify the default group required for installation.

Fix

If it's related to Default Group, navigate to your Admin Management section on https://admin.atlassian.com
Click on Product Access you'll see the below popup box, then click on Review Imported groups
Click on Approve for all Groups

6/ Atlassian are experiencing a problem validating app descriptors

Sometimes, Atlassian’s app descriptor validation does not work correctly and prevents apps from being installed.

An example of this happening occurred on June 13, 2023:

At the time, Atlassian's status page did not show any message about this degradation of functionality for a few hours.

As this particular situation is pretty obscure and difficult for end users to troubleshoot, our advise here is to ask us (if it’s our app) or your app vendors, or perhaps open a ticket with Atlassian.

7/ Something has momentarily failed at Atlassian and you really should try again in a bit

We’re all human. Sometimes things really do fail.

You should take a look at Atlassian's status page and see if there’s any outage.

Alternatively, wait a while and try again.

For other Atlassian Marketplace vendors:

This page is licensed under Creative Commons Attribution-ShareAlike 4.0 (CC BY-SA).

Please link back to the original article as follows:
Error message on app install – We ran into a little trouble / It may just be a hiccup • David Simpson Apps