All Collections
Getting Started with Summit
Previewing & Publishing Your App
Publishing, Sharing, Embedding, & Activating API Access for Your App
Publishing, Sharing, Embedding, & Activating API Access for Your App

Learn how to publish your project as an app, embed an app in a web page, and/or connect a simulation to an external system.

Updated over a week ago

How do I publish my project as an app?

After creating or editing the logic for your project, then customizing the appearance and behavior of your app, the next step is to Publish your app. Once your app is published, you will be able to share it, embed it, or power it remotely using our API.

To publish a project as an app, first select the project you wish to publish from the Dashboard. From the Board or Configure App view, click the button labeled Publish. You will then be presented with various options that will determine who can access your app after it is published:

Access options when publishing an app in Summit

Make a selection and then click Publish app. A confirmation window will appear that will then direct you to the published version of the app.

πŸ”” Note: You can change the access settings to the app at any time by clicking the Settings button at the top of the screen, selecting the tab labeled App, and choosing your desired access controls as before (see above). After making a selection, click the X to close the window and your app will now be updated with the desired permissions.

You can also make this change when publishing a new version of the app. Click Publish, select your access settings, then click the Deploy new version button. The app will then be published as a new version with the selected access settings.

How do I share an app?

You can generate a sharing link from the Hosted app tab under Project settings. Simply click the Copy button next to the URL field displayed under the heading Your app lives at... <URL>.

How to generate a link to share your Summit app.

Alternatively, when viewing the published version of the app, you can click the Share button in the top-right corner of the screen. After clicking this button, a window will appear with various sharing options under the Share tab:

  1. Choose to include the current values entered in the app's input fields as default values for visitors to your app by clicking the checkbox next to the text Include current values. Leave the box unchecked if you prefer the default values to be blank.

  2. You can rename the shared version of the app by typing in a new title for the app under the section Customize Title.

  3. You can also customize the app description that appears below the title by typing in a new description under the section labeled Customize description.

How to generate a sharing link for your app in Summit

Once you've made your selections, click the Copy button to copy the sharing link to your clipboard. You can then paste the link wherever you'd like to provide your audience with access to your app (according to the sharing permissions set when publishing the app).

How do I embed my app in a webpage?

You can embed your app in a webpage using a simple iframe. To generate the HTML snippet, open the project you wish to embed, publish your app, then click the Settings button, and make sure the toggle switch labeled Enable embedding is in the active position for your project. The Embed code that appears is the snippet of HTML you can copy and then paste into your website or application code in order to render your Summit app inline. It's that easy!

How to embed your Summit app in a webpage

This window also gives you the option to let visitors share the app by embedding it where they wish as well. To enable this feature, simply click the toggle labeled Allow anyone to embed this app and users will see Embed as a sharing option.

πŸ”” Note: When this toggle is in the active position, the option to allow embedding on only certain domains is removed. Learn more here.

How to let anyone embed your Summit app in a webpage

For additional details about app embedding, please refer to this article in our Technical Reference Guide.

πŸ”” Note: Runs of a free embedded app count as model runs against your account credits. Free plans are limited to 250 runs total before requiring an upgrade to Summit Pro. For more information about Summit subscriptions and answers to common questions, see our Pricing page.

How do I adjust the size of the embedded app to fit my webpage?

If the default embed code does not match the size or scale requirements for your website, you can copy the snippet below (remember to add your iframe embed node where noted) and adjust the values (width, padding, position, et al.) to force an aspect ratio for the embedded display on the most common screen sizes and devices.

<style> #summit-app { width: 100%; position: relative; display: block; overflow: hidden; } #summit-app::before { content: ''; display: block; padding-bottom: 133.34%; } @media (orientation: landscape) { #summit-app::before { padding-bottom: 62.5%; } } #summit-app>iframe { position: absolute; top: 0; left: 0; right: 0; bottom: 0; width: 100%; height: 100%; overflow: scroll; } </style> <div id="summit-app"> <!-- Your Summit iframe embed code here --> </div>

If you run into any issues or would like some assistance, we're also happy to provide guidance on the values to use or update the code snippet for you so your app appears as expected. Just send us a message with a link to the destination webpage and details about your layout requirements for the app and we'll get right back to you! Contact us here.

How do I embed an app that I've visited on another webpage?

Similar to the method for sharing a published app (see above), apps that allow embedding (see above also) can be embedded wherever you'd like. Click the Share button in the top-right corner of the app you've visited. Select the Embed tab on the window that appears. You have the option to include the current values entered in the app's input fields as default values for visitors to the embedded app by clicking the checkbox next to the text Include current values. Leave the box unchecked if you prefer the default values to be blank. After making a selection, simply click Copy to copy the embed code and then paste into your website or application code to render the Summit app inline. Simple!

How to generate a embed code on a shared app

How do I use the API to run my app from anywhere?

The configuration to power your app from anywhere via API is just as simple as creating a public app in Summit. To get started, open the project you wish to connect to, publish your app, then click the Settings button, and make sure the toggle switch labeled Enable API access is in the active position for your project. The API endpoint will then appear that allows you to manage API keys for that specific app. Simple as that!

How to enable API access for your project in Summit

For additional details about configuring API access and learning how to run your app via API, please refer to this article in our Technical Reference Guide.


Did this answer your question?