User Interface Considerations

Canvas Size

The frame size for canvas apps varies depending on the location where the app appears. When using the SDK, these values are returned in the Dimensions object.

If you plan to use your canvas app in the Salesforce mobile app, take into account mobile device screen sizes. For more information, see Canvas in the Salesforce Mobile App.

Note

Location	Description
Chatter tab	The default dimensions are 800 pixels (wide) by 900 pixels (high). The maximum dimensions are 1,000 pixels (wide) by 2,000 pixels (high).
Chatter feed	The default dimensions are 420 pixels (wide) by 100 pixels (high). The maximum dimensions are 420 pixels (wide) by 400 pixels (high).
Open CTI	The default and maximum dimensions are determined by the way you set up the custom console component.
Publisher	The way you set up the canvas publisher action determines the default height. The default width is 522 pixels. The maximum dimensions are 522 pixels (wide) by 500 pixels (high).
Salesforce Console	The default and maximum dimensions are determined by the way you set up the custom console component.
Visualforce page	The default dimensions are 800 pixels (wide) by 900 pixels (high). A developer can change these dimensions by modifying the attributes on the apex:canvasApp Component.

Logo Image

The logo image associated with a canvas app is displayed when someone installs your canvas app or during OAuth authentication when the user is prompted to allow the app to run. We recommend that you use an image of size 256 pixels (high) by 256 pixels (wide).

Icon Image

The icon image associated with a canvas app is displayed in these locations.

To the left of the link to your canvas app on the Chatter tab, in the Chatter apps list
To the left of the link to your canvas app in the Canvas App Previewer
In the Salesforce navigation menu

We recommend that you use an image of size 60 pixels (wide) by 60 pixels (high) so that the icon appears correctly in both mobile and the Salesforce site. If you have no plans to display your icon in the Salesforce mobile app, you can use a smaller icon size of 16 pixels (wide) by 16 pixels (high).

Thumbnail Image

The thumbnail image associated with a canvas app feed item is displayed when someone accesses your canvas app in the feed. If specified, this image appears next to the feed item title and description.

We recommend that you use an image of size 120 pixels (wide) by 120 pixels (high) or smaller.

See Also