Can I embed the template editor on my website?

Use Sessions ↗ to provide your users with access to the Bannerbear template editor. When you create a Session, you'll receive a session_editor_url, which provides a secure and expiring access to the Bannerbear template editor for a specific template. This link can be used by your users, even if they are not a Bannerbear member.

Create a Session

Ensure that Web Sessions are enabled in your project settings:

  1. Head to your Project
  2. Settings / API Key
  3. Advanced
  4. Enabled Web Sessions
  5. Save

Send a POST request to /sessions with the template uid (unique ID) that you want to grant access to. You can also include an optional metadata string.

The API will respond with a secure link under"session_editor_url" that you can embed as an iframe, or you can send to your users directly (they would see the bannerbear.com domain in this case).

Retrieve a Session

You can make a  GET request to the /sessions/:uid endpoint for the Session information referenced by its uid.

Preview Mode

You can start a session in preview mode (no editor tools, read-only) by passing the {preview_mode: true} parameter when creating a Session.

{
	"template" : "TEMPLATE_UID_HERE",
	"mode": "preview"
}

Further, you can append a ?modifications= query string to load the preview mode Session with custom modifications. This may be useful when showing users template edits before rendering images.

The modifications query string parameter should be a base64 encoded payload of JSON modifications as per the standard Images API.

Example:

YOUR_SESSION_URL/?modifications=W3sibmFtZSI6InRpdGxlIiwgInRleHQiOiAidGhpcyBpcyB0aGUgdGl0bGUgdGV4dCJ9XQ==

Limited Mode

Unlike preview mode, this allows editing of existing template layers but doesn't allow for layers to be added or deleted.

{

"template" : "TEMPLATE_UID_HERE",

"mode": "limited"

}


Alternatives

Have a question?

Contact our customer support team anytime via chat or email