# apex:insert

A template component that declares a named area that must be defined by an `<apex:define>` component in another Visualforce page. Use this component with the `<apex:composition>` and `<apex:define>` components to share data between multiple pages.

## Example

```apex
<!-- Page: composition -->
<!-- This page acts as the template. Create it first, then the page below.  -->	
<apex:page>
    <apex:outputText value="(template) This is before the header"/><br/>
    <apex:insert name="header"/><br/>
    <apex:outputText value="(template) This is between the header and body"/><br/>
    <apex:insert name="body"/>
</apex:page>
            
<!-- Page: page -->
<apex:page>
    <apex:composition template="composition">
    <apex:define name="header">(page) This is the header of mypage</apex:define>
    <apex:define name="body">(page) This is the body of mypage</apex:define>
    </apex:composition>
</apex:page>
```

The example above renders the following HTML:

```html
(template) This is before the header<br/>
(page) This is the header of mypage<br/>
(template) This is between the header and body<br/>
(page) This is the body of mypage
```

## Attributes

| Attribute Name | Attribute Type | Description                                                                                              | Required? | API Version | Access |
| -------------- | -------------- | -------------------------------------------------------------------------------------------------------- | --------- | ----------- | ------ |
| `name`         | String         | The name of the matching define tag that provides the content to be inserted into this Visualforce page. | Yes       | 10.0        | global |

**See Also**

- [apex:composition](/docs/platform/salesforce-pages-developers-guide/guide/pages-compref-composition.md)
- [apex:define](/docs/platform/salesforce-pages-developers-guide/guide/pages-compref-define.md)