Force.com Canvas Developer's Guide

Getting Started
Introducing Force.com Canvas
Force.com Canvas Scenarios
Where Canvas Apps Appear
Supported Browsers
Supported Salesforce Editions
User Permissions Required
User Interface Considerations
Canvas App Process
Canvas Personal Apps
Quick Start
Quick Start—Advanced
Using Force.com Canvas
Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

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 Salesforce1, take into account mobile device screen sizes. For more information, see Canvas in the Salesforce1 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 Salesforce1 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 Salesforce1 and Salesforce. If you have no plans to display your icon in Salesforce1, 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.