Include placeholders for app deployment

On the product UI, an app can be rendered in any of the locations that the module supports. This module supports rendering an app in common placeholders and module-specific placeholders.

To render an app in the common placeholder, in manifest.json > modules.common.location.<placeholder-name>, you can specify the placeholder in the product’s left-navigation pane where the app is eventually rendered.

To render an app in a module-specific placeholder, in manifest.json > modules.contact.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 > modules.
  • Freshworks product apps are supported only as web apps (and not as mobile apps).

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

Common placeholders

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

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.

left_nav_chat

The app runs in the background and the app icon is displayed at the bottom-left corner. This placeholder supports messaging apps only.

Image of app in account details sectionApp rendered at left_nav_chat placeholder

Freshsales Suite - 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

contact_quick_actions

The app is displayed as an option in the more options menu of the contact details page.

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