Embed Apps for Confluence/Jira

Inserting into Confluence content

There are three methods to insert the macro and embed external apps:

1. Type /[app name] in the editor and select the app from the dropdown.

2. Copy a public share link for the app and paste it into the editor to autoconvert.

3. Or alternatively:

   1. Select the + icon in the Confluence editor, then View more.

   2. Search for “[app name]” or find it in the External content category.

   3. Select the app and the macro will be inserted.

Open

Editing and saving in Confluence

1. Hover over the macro in the Confluence editor.

2. Click the pencil edit icon to open the custom macro editor.

3. Change the config options in the left-hand panel to see a live preview.

4. Click the bottom-right Save button to save changes.

Inserting into Jira issues

1. Click the triple-dot dropdown at the top of an issue, then select the relevant app.

2. Note: if you create duplicate panels, just hide all but one. The beauty of these apps it they’re cross-compatible so you only need to insert one panel and can then add any licensed app as a new tab.

Open

Inserting into Jira dashboards

1. Click the Edit button in the top-right.

2. Search for the app name and click Add.

Editing and saving in Jira

• In Jira, the config panel can be opened by clicking the top-right config button.

• Basic tab inserts, edits and reordering can be performed without needing to open the config panel.

• When you’ve finished making changes, click the top-right blue button to save changes.

Inserting links to external apps

• Ctrl/Cmd+C and Ctrl/Cmd+V to copy-paste links into the macro.

• Links generally need to be set to public in order to display properly (see relevant app docs).

• Both public links and <iframe> embed code can be pasted into the macro.

• If you notice a link does not work, please contact us so we can fix it: support@appsplus.co

Autoconvert links in Confluence

• Copy-paste a public share link directly into Confluence editor to automatically embed that app.

• If you notice a link does not autoconvert, please let us know: support@appsplus.co

• Note: Atlassian limits app descriptors to 200 autoconvert links. As a result we’ve had to selectively remove autoconvert in the Tabs+ Pro for Confluence app for all static web hosting apps such as Netlify, Heroku, Vercel etc. You can still copy-paste these links into the macro editor.

Creating, editing and ordering tabs

• To add a new tab either click the + button in the top-right or Add New in the left-hand panel.

• Select the desired app from the list of options or paste a public share link directly.

• Once a valid link has been pasted additional config options will be available in the left-hand config panel.

• Tabs can be reordered by drag-drop either in the tab bar or the left-hand config panel.

Changing the display options

1. Click the Display tab in the left-hand config panel.

2. Toggle and change various display options to see real-time preview.

How to export and import data

1. Click the Export tab in the left-hand config panel.

2. Toggle on the type of data you wish to export/import: tabs or display.

3. Copy-paste this data into any other compatible app macro (Confluence or Jira).

Important note on data storage

We prefer to keep all data safely within your Confluence/Jira instance and as such don’t store any data on our servers. However Atlassian makes this difficult by giving developers a tiny 32kB storage container to work with which can be easily exceeded with the notes or whiteboard feature in our apps.

Below is a brief of how we workaround that limit to keep your data secure:

• Confluence: data is stored in a content attachment JSON.

  • This is unconventional but works quite well for storing large datasets (eg tab notes or whiteboards).

  • You can find the JSON filename associated with the macro in the macro editor Export tab.

  • You’ll see the JSON file alongside your regular Confluence attachments.

  • DO NOT DELETE the JSON file named similar to appsplus-tabs-data-nIDq0Ml4ee.json

  • Should you accidentally delete the file, contact your Confluence admin to restore it.

• Jira: data is stored across multiple issue content properties.

  • We could have taken the same Confluence approach but since attachments are displayed inline on issues this would have been an ugly solution. Thus the default whiteboard app is not available in Jira.

Licensing for apps and bundles

• All of the bundles and apps listed below are compatible with each other.

  • eg if you have both Figma+ and Airtable+ installed and licensed then you’re able to use the apps interchangeably. Figma macro will be accessible within the Airtable macro, and vice versa.

• When you install and license a bundle, all included apps will be accessible across all compatible apps.

• If in the future you happen to be double-paying for licenses of the same app (eg you installed Figma+ and then later installed the Design Bundle+) you can simply “unsubscribe” Figma+ in the Universal Plugin Manager without uninstalling the app. This will allow users to continue to use Figma+ without double-paying for a license.

Bundles

Apps

List of all compatible apps including example structures of public share links.