---
title: "Bentomatics"
canonical: "https://docs.pbs.org/space/B3/4751562/Bentomatics"
format: markdown
---
> Macro (toc)

## What is Bentomatic?

Bentomatic is a standalone Bento page that is created just like any other Bento page but can be packaged, assigned permissions, and distributed to other Bento sites. Additionally, Bentomatic pages that were built by other stations or producers can be included on your Bento site, if permissions have been assigned to you. That means you can add content to your website with very little effort and the content that you create can potentially be shared with a wider audience.

All Bento [components](https://docs.pbs.org/space/B3/4751450/Component+Library) can be used to build a Bentomatic page.

There are four different things you can do with Bentomatic:

1. **Create** a Bentomatic page
2. **Save **a Bentomatic page to the Bentomatic library
3. **Add** a Bentomatic page to your Bento site
4. **Customize** Bentomatic variables

## Some Bentomatic facts

- **Changes transfer. **When a Bentomatic is modified, the changes surface wherever the Bentomatic component surfaces. That means if you make a change to your Bentomatic and another station has implemented your Bentomatic on their site, the change displays on their site as well.
- **Can be customized.** Additional content can be added to the page that holds the Bentomatic component without affecting the Bentomatic content.
- **Use your components. **Any Bento [component](https://docs.pbs.org/space/B3/4751450/Component+Library) can be used with Bentomatic.
- **Go ahead and share. **Bentomatic pages can be shared with any Bento site.
- **Sharing is unlimited. **Bentomatic pages can be distributed to an unlimited number of destinations; there is no limit to the number of times a Bentomatic page can be shared.
- **Get creative.** The [embed component](https://docs.pbs.org/space/B3/4751472/Embed) can be used to add custom code.
- **Can add to a variety of layouts.** A Bentomatic can be added to 1 column, 2 column, 2/3-1/3 column, and 3 column [page block layouts](https://docs.pbs.org/space/B3/4751444/How+to+Create+a+Page#How-to-select-a-block-layout).
- **Publish before sharing. **A Bentomatic page must be published in order to be shared with other sites.
- **Affects block functionality.** Adding a Bentomatic to a block on your page disables the copy and cut features on that block. The rest of the blocks on the page are unaffected.

> ✅ ### A real life scenario
> ✅ 
> ✅ ***Thanksgiving is fast approaching!*** You need content for your site and the PBS Food team has built a Bento page containing all kinds of great Thanksgiving Day recipes. The PBS Food team has saved the page as a Bentomatic component called** *****PBS Thanksgiving Recipes***. Your station wants to share this with your audience so you create a page on your site and add the *PBS Thanksgiving Recipes* content simply by adding the Bentomatic component.
> ✅ 
> ✅ All of the content from the *PBS Thanksgiving Recipes* Bentomatic page appears on your Bento site, along with any other unique content that you have added to the page. All of your site's branding (e.g.: header, footer, right rail, etc) is retained and displays on the page.
> ✅ 
> ✅ ***Congratulations! *** You have just added content to your site with just a few simple clicks.

## How to create a Bentomatic 

Creating a Bentomatic page often means that you are creating content that you want to share with other sites. This section demonstrates how to create a Bentomatic page that can be shared with other Bento sites.

- From your main pages menu, [create a new page](https://docs.pbs.org/space/B3/4751444/How+to+Create+a+Page) to hold your Bentomatic (Figure 1).

<span style="color: #000000">Figure 1</span>

![create-bentomatic-new1.jpg](media://a5af08e8-5252-44fc-afdc-9bef56b04507)

<span style="color: #000000">All page available page layouts display. </span>

- <span style="color: #000000">Click the </span><span style="color: #000000">**layout **</span><span style="color: #000000">you want to use (Figure 2.1).</span>
- <span style="color: #000000">Click </span><span style="color: #000000">**Create **</span><span style="color: #000000">(Figure 2).</span>

<span style="color: #000000"> Figure 2</span>

![create-bentomatic-new2.jpg](media://34bd3342-5b63-4149-b4f1-de0d69ac79bc)

- In the Page Title textbox, type a **title** for your new page (Figure 3.1). The Pathname field auto-populates and we recommend you do not change it.
  - The Pathname URL auto-populates as you type the page title (Figure 3.2). We recommend you do not change this.
- Click **Bentomatic Settings** to expand the Bentomatic menu (Figure 3.3).

Figure 3

![create-bentomatic-new3.jpg](media://049b7917-3cce-460c-b115-80255ebe704b)

- Click the **toggle **next to Make Bentomatic so that it displays **ON**, indicating the page is now an active Bentomatic (Figure 4).

<span style="color: #000000">Figure 4</span>

![create-bentomatic-new4.jpg](media://6b2809c5-2d11-499c-991d-e237daad359d)

- In the Title textbox, type the **title of your Bentomatic** (Figure 5.1). This is the title that people search for when they want to add your Bentomatic to their site.
- ***By default, your Bentomatic is available to all Bento sites*** (Figure 5.2)***.***
  - To restrict your Bentomatic to specific sites, in the *Shared With* section, begin typing the **name of the site** with which you want to share it (Figure 5.3). When the name of the site displays, click it (Figure 5.4). You can search for and select an unlimited number of sites.
- When finished, click **Save** (Figure 5.5).

> ℹ️ In this example we are making our Bentomatic available to all sites.

Figure 5

![create-bentomatic-new5.jpg](media://9f624507-8228-4184-93fb-2738abca0f58)

- <span style="color: #000000">The Bentomatic has been saved and displays in your list of pages. Click the </span><span style="color: #000000">**page title**</span><span style="color: #000000"> to open the settings for this page (Figure 6)</span>

<span style="color: #000000">Figure 6</span>

![create-bentomatic-new6.jpg](media://c1f95697-8d23-46a8-8883-4750243cbbde)

- <span style="color: #000000">Click the </span><span style="color: #000000">**toggles**</span><span style="color: #000000"> next to Header, Footer, and Rail so that they display </span><span style="color: #000000">**ON**</span><span style="color: #000000"> if you want these elements to display on your page (Figure 6.1). </span><span style="color: #000000">[Learn more about headers and footers](https://docs.pbs.org/space/B3/4751484/Headers+and+Footers)</span><span style="color: #000000">  |  </span><span style="color: #000000">[Learn more about the rail](https://docs.pbs.org/space/B3/4751560/Rail)</span>
  - Even though you are including the header and footer on your site, when the Bentomatic is included in another site, it will inherit the header and footer of the site on which it's implemented.
- <span style="color: #000000">In the body of the page, being adding content (Figure 6.2). You can use almost </span><span style="color: #000000">[any component](https://docs.pbs.org/space/B3/4751450/Component+Library)</span><span style="color: #000000"> in your Bentomatic.</span>
- After you have included all content, click **Save** to save/publish the page and click **Preview **in the upper right side of the screen to preview the page in a browser (Figure 7).

> ❌ **Your Bentomatic must be published in order for it to be available to other sites.**

<span style="color: #000000">Figure 7</span>

![create-bentomatic-new7.jpg](media://bcd7ce72-b25e-4a22-b828-3cba54d5b8d6)

## How to add a Bentomatic to your site

> 📝 If you add a Bentomatic to a block on your site, the copy/cut feature on the block is unavailable. All other blocks on the page are unaffected.

Be sure you are on a site with which the Bentomatic component has been shared (Figure 2.1). If you need to request access to the Bentomatic you want to use, [please file a ticket](http://digitalsupport.pbs.org/support/tickets/new).

This section demonstrates how to add a Bentomatic to your site.

- From your main pages menu, **[create a new page](https://docs.pbs.org/space/B3/4751444/How+to+Create+a+Page)** to hold the Bentomatic (Figure 1).

<span style="color: #000000">Figure 1</span>

![create-bentomatic-new1.jpg](media://a5af08e8-5252-44fc-afdc-9bef56b04507)

- Click the **page layout **you want to use (Figure 2.1).
- Click **Create **(Figure 2.2).

Figure 2

![create-bentomatic-new2.jpg](media://34bd3342-5b63-4149-b4f1-de0d69ac79bc)

- <span style="color: #000000">In the Page Title textbox, type a </span><span style="color: #000000">**title**</span><span style="color: #000000"> for your new page (Figure 3.1). The Pathname field auto-populates and we recommend you do not change it. </span>
- <span style="color: #000000">Click the </span><span style="color: #000000">**toggles**</span><span style="color: #000000"> next to Header, Footer, and Rail so they display </span><span style="color: #000000">**ON**</span><span style="color: #000000"> if you want these elements to display on your page (Figure 3.2). </span><span style="color: #000000">[Learn more about headers and footers](https://docs.pbs.org/space/B3/4751484/Headers+and+Footers)</span><span style="color: #000000">  |  </span><span style="color: #000000">[Learn more about the rail](https://docs.pbs.org/space/B3/4751560/Rail)</span>
- <span style="color: #000000">When finished, click </span><span style="color: #000000">**Save**</span><span style="color: #000000"> (Figure 3.3).</span>

<span style="color: #000000"> Figure 3</span>

![add-bentomatic-new3.jpg](media://d9eba5b1-6d83-4da2-86cc-5017074e8961)

Click** Add Block **to begin adding the Bentomatic (Figure 4).

Figure 4

![add-bentomatic-new4.jpg](media://ecf81a0a-8981-4349-8700-5df6e6db419e)

- <span style="color: #000000">Click the </span><span style="color: #000000">**plus sign**</span><span style="color: #000000"> to surface the component menu (Figure 5.1).</span>
- <span style="color: #000000">In the More section, click </span><span style="color: #000000">**bentomatic**</span><span style="color: #000000"> (Figure 5.2).</span>

> ⚠️ **Your site has to be given permission to use Bentomatic components. If you cannot find the Bentomatic component you want to use, check if the Bentomatic component is assigned to your site. **<span style="color: #000000">**To request access to a Bentomatic, **</span>**[please file a ticket](http://digitalsupport.pbs.org/support/tickets/new)**<span style="color: #000000">**.**</span>

Figure 5

![add-bentomatic-new5.jpg](media://74b4d809-af4a-41f3-9681-b56bb68d423b)

- <span style="color: #000000">Click the </span><span style="color: #000000">**Bentomatic Consumer box**</span><span style="color: #000000"> (Figure 4.1).</span>
- <span style="color: #000000">On the left side of the page, in the Source textbox, begin typing the</span><span style="color: #000000">** name of the Bentomatic**</span><span style="color: #000000"> that you want to add to your page (Figure 4.2). This is the title that was added in Figure 3.1 above in the </span><span style="color: #000000">*How to Create a Bentomatic*</span><span style="color: #000000"> section.</span>
- <span style="color: #000000">When the title of the Bentomatic appears, click the </span><span style="color: #000000">**title**</span><span style="color: #000000"> (Figure 4.3). </span>

> ⚠️ **If the Bentomatic you are looking for doesn't appear, you either do not have access to it or it has not been published. You can ****[file a ticket](http://digitalsupport.pbs.org/support/tickets/new)**<span style="color: #000000">** to inquire.**</span>

<span style="color: #000000">Figure 6</span>

![add-bentomatic-new6.jpg](media://fb3088a3-8a2f-47f5-b96a-71b30975a974)

- <span style="color: #000000">After you have added or modified any content on the page, save or publish the page and click </span>**Preview **<span style="color: #000000">in the upper right side of the screen to preview the page in a browser (Figure 7).</span>

> ⚠️ <span style="color: #000000">**You do not have to use a Bentomatic page in its exact original form.**</span><span style="color: #000000"> You can modify </span><span style="color: #000000">***all custom components***</span><span style="color: #000000"> in the Bentomatic page to include content that is relevant to your specific station or site. These changes can be made through the Bentomatic component that you have added to a page on your site.</span>

<span style="color: #000000">Figure 7</span>

![add-bentomatic-new7.jpg](media://f497cd76-e4e7-42d9-a284-d85bdcbec4ab)

## <span style="color: #000000">Bentomatic iFrame code</span>

<details>
<summary>Watch a demo</summary>

![bentomatic-iframe.mp4](media://9e9325b1-1b5e-4681-b433-3fd160bbb869)
</details>

<span style="color: #000000">Bentomatics can be shared on any external (i.e.: not Bento) website using the iFrame code that can be found on shared Bentomatic source pages. Two things must be true in the </span><span style="color: #000000">*Bentomatic Settings*</span><span style="color: #000000"> section in order for a Bentomatic to be shared using iFrame code:</span>

1. <span style="color: #000000">The </span><span style="color: #000000">*Make Bentomatic*</span><span style="color: #000000"> toggle must display ON</span>
2. <span style="color: #000000">The Bentomatic must be shared with ALL SITES</span>

![image](media://86af976b-442d-4524-a123-15bea953ec34)

### <span style="color: #000000">How to implement iFrame code</span>

- <span style="color: #000000">From the Bentomatic source page, click </span><span style="color: #000000">**Bentomatic Settings**</span><span style="color: #000000"> to expand the section (Figure 1).</span>

<span style="color: #000000">Figure 1</span>

![image](media://464ab793-de74-4c44-836c-d6509823ad4f)

- <span style="color: #000000">Make sure the Make Bentomatic toggle displays ON (Figure 2.1).</span>
- <span style="color: #000000">Make sure the Bentomatic is shared with ALL SITES (Figure 2.2).</span>

<span style="color: #000000">Figure 2</span>

![image](media://9a86ed4a-d246-43bb-ab67-d07d7a4e51a9)

- <span style="color: #000000">Click </span><span style="color: #000000">**Get iframe Code**</span><span style="color: #000000"> (Figure 3).</span>

<span style="color: #000000">Figure 3</span>

![image](media://aa599e44-0033-4440-89e6-21eb1d71bde2)

- <span style="color: #000000">The code displays (Figure 4.1). </span>
- <span style="color: #000000">Click</span><span style="color: #000000">** Copy Iframe Code**</span><span style="color: #000000"> to copy the code to the clipboard (Figure 4.2).</span>
- <span style="color: #000000">Click </span><span style="color: #000000">**Cancel **</span><span style="color: #000000">to back out of the iFrame code popup (Figure 4.3).</span>

<span style="color: #000000">Figure 4</span>

![image](media://f65f7657-c8b8-45e8-b0b7-964355f45133)

## <span style="color: #000000">Creating reusable content </span>

<span style="color: #000000">You can create reusable content that can easily be customized by the consumer. This is done by assigning variables to text and images. </span><span style="color: #000000">[Learn more](https://pbs-docs.atlassian.net/wiki/spaces/B3/pages/4751564)</span>

## Bentomatic FAQ

#### Can a Bentomatic be added to a Bentomatic page?

If a page is already a Bentomatic page, a Bentomatic cannot be added to it. You can, however, add a Bentomatic to a non-Bentomatic page*** that is in Draft mode*** and then make the page a Bentomatic before publishing the page.

#### Can I add content between items on a Bentomatic page?

No. You can add content above and below the Bentomatic component but you cannot insert content between items that are contained within the Bentomatic component. You can rearrange items within a Bentomatic page but the original items cannot be separated by other custom content.

#### Can I change the Google Analytics code in a Bentomatic component?

No. You should not modify the Google Analytics component that comes with the Bentomatic page. You should already have your own code in the Explorer Google Analytics in the First in Head section.

#### Can all Bentomatic pages be customized?

No. Not all Bentomatic pages can be customized. The SPI team will send emails out informing you which can be edited and which cannot. 

#### Can I rearrange items within a Bentomatic page?

Yes. Content in components can be rearranged inside the Bentomatic page.

#### Can I create national Bentomatic pages to be shared?

Yes. [Contact your SPI representative](http://digitalsupport.pbs.org/support/tickets/new) to discuss.