Include placeholders for app deployment

On the Freshservice UI, an app can be rendered in multiple locations (pages). When you configure the app manifest, in manifest.json > manifest.json > product.freshservice.location.<placeholder-name>, you can specify the placeholder on a page where the app is eventually rendered.

Notes:
  • You can specify multiple placeholders in manifest.json > location.
  • Freshservice apps are supported as web apps.

full_page_app

The app icon is displayed on the left navigation pane and when clicked, the app page occupies the entire viewport.

The placeholder can have only one active app at a time.

Image of full page app in Freshservice

cti_global_sidebar

The app icon is displayed at the bottom-left corner. This location is allocated for an app that uses the Computer Telephony Integration (CTI) technology. The default width and height of the app are 360 pixels.

The placeholder can have only one active app at a time.

Note:The placeholder can have only one active app at a time. If the product account has a native CTI app of Freshservice and a custom-built CTI app installed, then the native CTI app is given preference and will be displayed at the placeholder.

Image of full page app in Freshservice

Ticket details page

ticket_sidebar

The app is displayed in the right sidebar on the Ticket details page and is loaded only after you click the app icon.

Image of app in Ticket Details pageApp rendered at ticket_sidebar placeholder in the Ticket Details page

ticket_requester_info

The app is displayed on the Requester details tab and is loaded only after you click the app icon.

Image of app in Requester Details tabApp rendered at ticket_requester_info placeholder in the Requester Details tab

ticket_top_navigation

The app is displayed on the top navigation bar on the Ticket details page and is loaded only after you click the app icon.

Image of app in Ticket Details pageApp rendered at ticket_top_navigation placeholder in the Ticket Details page

ticket_background

The app runs in the background of the Ticket details page.

Change details page

change_sidebar

The app is displayed in the right sidebar on the Change details page and is loaded only after you click the app icon.

Image of app in Change Details pageApp rendered at change_sidebar placeholder in the Change Details page

change_background

The app runs in the background of the Change details page.

Contact details page

contact_sidebar

The app is displayed in the right sidebar on the Requester Details page.

New ticket page

new_ticket_sidebar

The app is displayed in the right sidebar on the New ticket page.

Image of app in New Ticket pageApp rendered at new_ticket_sidebar placeholder in the New Ticket page

new_ticket_background

The app runs in the background of the New ticket page.

New change page

new_change_sidebar

The app is displayed in the right sidebar on the New change page.

Image of app in New Change pageApp rendered at new_change_sidebar placeholder in the New Change page

new_change_background

The app runs in the background of the New change page.

Asset details page

asset_sidebar

The app is displayed in the right sidebar on the Asset details page.

Image of app in Asset Details pageApp rendered at asset_sidebar placeholder in the Asset Details page