Include placeholders for app deployment

On the Freshsales Suite UI, an app can be rendered in multiple locations (pages). When you configure the app manifest, in manifest.json > manifest.json > product.freshworks_crm.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.
  • Freshsales Suite apps are supported only as web apps (and not as mobile apps).
  • To migrate a Freshsales Classic app as a Freshsales Suite (identified as freshworks_crm in the manifest.json file) app, replace the Freshsales Classic placeholders with the appropriate Freshsales Suite placeholders, in the location object.

This section provides information on all locations (and the placeholders in these locations) where an app can be rendered.

full_page_app

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

Image of full page app in Freshsales SuiteApp rendered at full_page_app placeholder

Contact details page

contact_entity_menu

The app is displayed in the left navigation pane of a contact details window.

Image of app in the deal details sectionApp rendered at contact_entity_menu placeholder in the Contact details page

Deal details page

deal_entity_menu

The app is displayed in the Deal details section of the deal details page.

Image of app in the deal details sectionApp rendered at deal_entity_menu placeholder in the Deal details page

Sales account details page

sales_account_entity_menu

The app is displayed in the Account details section of the account details page.

Image of app in Sales account details pageApp rendered at sales_account_entity_menu placeholder in the Sales account details page

CTI

left_nav_cti

The app runs in the background and the app icon is displayed at the bottom-left corner. This placeholder supports an app that uses the Computer Telephony Integration (CTI) technology.

Notes:
  • Ensure that the app icon's resolution is 20 x 20 pixels.
  • This placeholder can display only one CTI app at a time. Freshcaller is also considered as a messaging app.