How to Embed Visualforce Pages in Visualforce Pages – Issues and Solution

Have you ever had challenges trying to include a Visualforce page from another application (e.g. a managed package)? You are not alone!

The proliferation of creating managed packages (a collection of Force.com components made available to others through the AppExchange) in Salesforce, and the impact to the UI/UX experience in trying to incorporate a page from a managed package into your organization’s Community site or application, has come up with a number of our clients. One solution is using iframe, but the page loses all of its styling and power. To help address this requirement, we needed to find a better way to embed a Visualforce (VF) page within a Visualforce page. This blog post will outline the issue a client was having and how I was able to work around it.

• The org had a managed package installed which provided Admins the ability to add/modify logos, images and headlines and store it in a custom object. A VF page within the package was pulling the content from the object and displaying the images, headlines and logo based on certain parameters.
• The main challenge was to embed the VF page from the managed package into the portal’s custom home page. The look and feel should be uniform across the embedded page and parent page.

The most obvious solution was using iframe.  However, I faced several issues while implementing the functionality using iframe:

• The VF page within the iframe did not inherit the styling of the parent page.
• The styling of the iframe was off and it distorted the styling of the parent page in which it was embedded as well.
• The look and feel was not good due to the scrollbars.

The other option was to use the <apex: include> tag which provides the ability to include a VF page within a VF page. I could not use it either as parameters cannot be passed to the embedded VF page using this tag.

However, I was able to find an alternative solution which worked perfectly. I used <apex: outputtext> to embed a VF page within Salesforce’s VF page. Let’s take a simple example to better understand the implementation steps I used.

Visualforce Page:

Apex Class:

The Manufacturer’s Guide to Marketing Through Partner Enablement in 2021

Learn how partnerships allow manufacturers to scale revenue growth beyond what’s possible with direct sales alone.

Get the Guide

In this example I am trying to embed a standard Salesforce Case page within a VF page using <apex:outputtext>. The content of the page reference is converted into a String using getContent().toString() and passed to the <apex:outputtext> component on the page. Any Visualforce page or standard Salesforce URL can be embedded in the same manner.

Remember to set the attribute escape as false in order to display the UI of the page. Otherwise, the page content will be displayed as text.

Below are a few advantages of using outputText over iframe-

• The child page becomes part of the parent page and hence eliminates problems like cross browser scripting errors.
• I can simply refer the HTML ID’s and class names of the embedded page within any JavaScript or CSS. The embedded child page becomes part of the parent page, unlike iframe, where in the components can only be accessed through iframe.content window making the JavaScript code complex.

Screenshot of the page displayed using <apex: outputtext/>.

This is how an <apex: outputtext > displays the standard case page within a Visualforce page by embedding it within the HTML of the parent page.

Intellectual property protection, built-in versioning support, ability to branch and patch previous versions, and unique naming of all components are just a few examples of the benefits of managed packages and how they can give you a lot of options when it comes to working with Visualforce pages. Hopefully this technical post on how you can better incorporate them into your application development process was helpful.