Guides & References

guides home

How to: Embed on a web page

Our app is designed to be embedded in other web pages in an iframe element. We provide support for a seamless embedded application experience.

The basic steps to embed the application on another webpage are:

  1. Visit the App Factory at https://app-factory.appcatalyst.com and log in.
  2. Create and configure an app – the iframe related features are the following fields.
    • Embed – Set to yes. This enables the host and scroll rules fields and prevents the application’s height from being set to 100%;
    • Host – This field is required. It should reference the host page, the page that the iframe is on. This is required to enable iframeEmbedder/postMessage support and the iframe related support features.
    • Scroll Rules – By default, the host page will attempt to scroll back to the top of the iframe element when navigating between screens. As needed, configure the scroll rules to adjust this behavior if you have other fixed top navigation elements.
    • For more information on app configuration see the comprehensive guide.
  3. Copy the embed script from the button at the top of the App Factory – Application Details page.
  4. Create a new web page or identify an existing web page that you would like to embed the application in.
  5. Paste embed script on that page (the host page).
  6. Visit the host page.

Embed Script

Here is a little bit about our embed script and what you have just implemented.

The application management system provides a copy and paste snippet that includes the following html elements:

  • an iframe element with your application as the value for the iframe’s src attribute
  • a script reference to the iframeEmbedder library
  • an inline script to invoke iframeEmbedder and provide your app’s configuration details

iframe-embedder

We call the page that our app is embedded in the “host page.” We provide an additional script, iframeEmbedder.js, that can be added to the host page along with our application. It enables communication between the host page and symptom checker app to provide a seamless embedded app browsing experience.

The iframeEmbedder script adds support for the following features:

  • Automatically adjusts the height of the iframe when the embedded application’s size changes
  • Scrolls the host page back to the top of the embedded application when the embedded application’s page changes
  • Synchronizes the embedded application’s url with the host page’s fragment identifier to support links to states within the embedded application

We recommend that you use our snippet to embed the application in your web page. However, you could also create your own. Just use the launch app button to visit the application and use its url for your iframe’s src.

Children's Minnesota
Arkansas Children's
Saint Alphonsus
WellSpan Health
Children's Hospital of Colorado
Rady Children's Health
St. Elizabeth Physicians
Children's Hospital St. Louis BJC Healthcare
Children's Hospital Los Angeles
Children's Hospital of Wisconsin
Allegro Pediatrics
Assistance Services Group (ASG)
Stanford Medicine Children's Health
UPMC Children's Hospital of Pittsburgh
BJC HealthCare
Riverside Health
Citizens Memorial Healthcare
Children's Minnesota
Arkansas Children's
Saint Alphonsus
WellSpan Health
Children's Hospital of Colorado
Rady Children's Health
St. Elizabeth Physicians
Children's Hospital St. Louis BJC Healthcare
Children's Hospital Los Angeles
Children's Hospital of Wisconsin
Allegro Pediatrics
Assistance Services Group (ASG)
Stanford Medicine Children's Health
UPMC Children's Hospital of Pittsburgh
BJC HealthCare
Riverside Health
Citizens Memorial Healthcare
100+
Health System Implementations
750,000+
system app downloads
500+
Practices use our website content
1.5M+
website uses per year