# Source: https://loops.so/docs/creating-emails/components.md

> ## Documentation Index
> Fetch the complete documentation index at: https://loops.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Components

> Create re-usable elements for your emails.

Components are re-usable elements for emails. They help you create frequently-repeated sections of emails once, which you can then easily drop into new emails.

<img src="https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/components-example.png?fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=d39ec821ea9b4473748e425df1524496" alt="Components in an email" data-og-width="2280" width="2280" data-og-height="1314" height="1314" data-path="images/components-example.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/components-example.png?w=280&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=12f79dff5169414c4f3124b97925e207 280w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/components-example.png?w=560&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=9689c02d438f1a120a7d562f4341ce58 560w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/components-example.png?w=840&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=71b55f1c89f9135c6609f60a5da8d6b0 840w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/components-example.png?w=1100&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=18e1bd1eaaf8f8c0c02f0bf67e913985 1100w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/components-example.png?w=1650&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=b018d015048818ed098fb16b04507076 1650w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/components-example.png?w=2500&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=ad84cbc5cc06a689786d2b52e86e875b 2500w" />

Changes made to components can be synced to all other instances. You can also choose to make local edits to a single component instance without updating others.

Components can be created from and added to all emails created in Loops (campaign, loops and transactional emails). They also work in both Plain and Styled emails.

## Example components

Some useful examples of components are logos and social icons. These elements are typically the same across multiple emails; using components will make sure they are the same everywhere.

Most of the time you will want your logo to have the same alignment, spacing and size in your emails. Similarly, you will want the same set of social icons readily available to drop into every new email you create.

<img src="https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/example-components.png?fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=c8885b1b2b62fb0e3b19e39ae105301a" alt="Example components" data-og-width="2280" width="2280" data-og-height="1727" height="1727" data-path="images/example-components.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/example-components.png?w=280&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=f1579926de70d52b31d9c0da780d7f51 280w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/example-components.png?w=560&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=24da1c6266602fe65a99214273157586 560w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/example-components.png?w=840&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=e445c302335ad7dba32af8f1bd8e6d0b 840w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/example-components.png?w=1100&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=99ca79b787149f1b0f4904f8e804b532 1100w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/example-components.png?w=1650&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=c3dc0fe656f693f57487e35362828c92 1650w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/example-components.png?w=2500&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=0d037c5af52ddb396943a7aa51a5cbc1 2500w" />

## Create a component

To create a component, click on an element in your email and then the **Create component** icon in the editor panel.

<img src="https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/create-component.png?fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=fa864e9f3b22b0ae1f10b0d67c86c85e" alt="Create a component" data-og-width="2280" width="2280" data-og-height="1271" height="1271" data-path="images/create-component.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/create-component.png?w=280&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=f46e0208bbe2aed077f86f7dc6897e20 280w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/create-component.png?w=560&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=3a8f53b488533fd5d1c4ff719a15568c 560w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/create-component.png?w=840&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=5406493fa42788d6c82d68d1f5e4f577 840w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/create-component.png?w=1100&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=d2503e72a205a16b89eece105c830703 1100w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/create-component.png?w=1650&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=20f2961dd507cfc5ebd02a638648132a 1650w, https://mintcdn.com/loops/K9TRANbphBauR0pJ/images/create-component.png?w=2500&fit=max&auto=format&n=K9TRANbphBauR0pJ&q=85&s=4f4e13d4a2dfce26af98d7373e972ee3 2500w" />

A modal will appear where you can name your component. Use a descriptive name so you can easily find your component in the future.

Click **Create**. You will see your new component appear in the Components list on the left of the editor.

<Tip>
  All components you create are available in all of your emails, i.e. a component created in a campaign email is also available to insert into transactional emails.
</Tip>

## Insert a component

Click on **Components** at the top of the left-hand panel to reveal your components list, then simply click on a component to insert it.

<img src="https://mintcdn.com/loops/OG31ikb--92jQDlq/images/insert-component.png?fit=max&auto=format&n=OG31ikb--92jQDlq&q=85&s=69921ec0e7ac3682e2d7442f285f137e" alt="Add a component" data-og-width="2280" width="2280" data-og-height="1307" height="1307" data-path="images/insert-component.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/loops/OG31ikb--92jQDlq/images/insert-component.png?w=280&fit=max&auto=format&n=OG31ikb--92jQDlq&q=85&s=d9485949e3ddc6cc336ce20cc3a442ea 280w, https://mintcdn.com/loops/OG31ikb--92jQDlq/images/insert-component.png?w=560&fit=max&auto=format&n=OG31ikb--92jQDlq&q=85&s=d6a9ece1087bb7a747db584c9ded8c11 560w, https://mintcdn.com/loops/OG31ikb--92jQDlq/images/insert-component.png?w=840&fit=max&auto=format&n=OG31ikb--92jQDlq&q=85&s=8528d91bb64ac8dc2406b67a2f75fee3 840w, https://mintcdn.com/loops/OG31ikb--92jQDlq/images/insert-component.png?w=1100&fit=max&auto=format&n=OG31ikb--92jQDlq&q=85&s=937c58257419319afcfbfbe68c6da0d2 1100w, https://mintcdn.com/loops/OG31ikb--92jQDlq/images/insert-component.png?w=1650&fit=max&auto=format&n=OG31ikb--92jQDlq&q=85&s=82ccf77c88c400b91d4723d9b522cde5 1650w, https://mintcdn.com/loops/OG31ikb--92jQDlq/images/insert-component.png?w=2500&fit=max&auto=format&n=OG31ikb--92jQDlq&q=85&s=3f0de737cd8a091fca4892cb0858cec8 2500w" />

If you want to change the location of a component in your email, you can drag and drop it within the editor just like other blocks, by using the six dot menu icon.

If you already have a component in your email, clicking **Duplicate** in the **Block styles** editor panel will add a copy of that component into the email, including any local edits made.

## Edit a component

<Tip>
  You can tell if an element in your email is a component by looking for a purple outline around the block in the editor.
</Tip>

To edit a component, edit its content as you would any other part of your email.

This will create local edits to that single instance; these edits are not synced to other components in use elsewhere. This means you can make tweaks and changes to a single instance of a component without updating all other instances.

If a component has local edits, you will notice the **Push changes** and **Reset changes** icons are now active.

<img src="https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/edited-component.png?fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=3f05a19989fa72ec46fca5e02be5e683" alt="Edited component" data-og-width="2280" width="2280" data-og-height="1248" height="1248" data-path="images/edited-component.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/edited-component.png?w=280&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=2858d601947df61faf72ce9717fee750 280w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/edited-component.png?w=560&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=0f437a7189e61c74e7f884d4d7a0da47 560w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/edited-component.png?w=840&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=7d20b9a690bf7f514e0fa5edbefac3cf 840w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/edited-component.png?w=1100&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=1cd4db2cc5095e6db6c8e88d75262e5b 1100w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/edited-component.png?w=1650&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=97b47a786a22dfa5a40f0b8f7ad871d8 1650w, https://mintcdn.com/loops/I7MiNuGd9K5dwTEQ/images/edited-component.png?w=2500&fit=max&auto=format&n=I7MiNuGd9K5dwTEQ&q=85&s=6c21d671b9f88313f44e183bf84c7116 2500w" />

If you want to save your changes to all instances of the component, click on the **Push changes to main component** button. Note that any local edits made to the component in other emails will be preserved.

<img src="https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/push-changes.png?fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=0c888ce3ce78a8b0d4c62aae29e7f14a" alt="Push changes to other instances" data-og-width="2280" width="2280" data-og-height="1248" height="1248" data-path="images/push-changes.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/push-changes.png?w=280&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=483b4dd20bfa0ab16b3f49ae0f1dc5d8 280w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/push-changes.png?w=560&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=bef1a4a6de046bc055425011da04b837 560w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/push-changes.png?w=840&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=bdf1df1866eed0bd7ee5627286fb0691 840w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/push-changes.png?w=1100&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=3e55c5daa6f8d7a70792aeb7ae0bd56d 1100w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/push-changes.png?w=1650&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=b46794ed7c4e942f60e54fdfc9923f7c 1650w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/push-changes.png?w=2500&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=8ed0d77e192bf9c704dc1fbdbd4ad60d 2500w" />

If you make local edits to a component that you want to revert, click the **Reset component changes** option.

<img src="https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/reset-changes.png?fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=be02d4d41c30eb3ab9d082c1beea6a41" alt="Reset component changes" data-og-width="2280" width="2280" data-og-height="1248" height="1248" data-path="images/reset-changes.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/reset-changes.png?w=280&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=76751f360602a353390450d545e6f9e7 280w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/reset-changes.png?w=560&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=b3e0d8fa1e990b0781dbc924f6570c8e 560w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/reset-changes.png?w=840&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=471769e26e68fc357189a372b64793ed 840w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/reset-changes.png?w=1100&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=f60dc80372e15795dbf60491ad749b3f 1100w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/reset-changes.png?w=1650&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=0006c62738ef98bc7511133c5be968d9 1650w, https://mintcdn.com/loops/W7EWSDUW0GR-XWrp/images/reset-changes.png?w=2500&fit=max&auto=format&n=W7EWSDUW0GR-XWrp&q=85&s=eeaffb5d7b94f25478ab1e633e5bee79 2500w" />

## Rename a component

In the Components list, find the component you want to rename, then click the `•••` menu icon. Click on **Rename** to show the rename modal.

Enter a new name and click **Rename**.

## Delete a component

<Warning>
  Deleting a component only deletes the component; it does not remove the component from emails.\
  A deleted component's contents will be retained by any email it was added to.
</Warning>

In the Components list, find the component you want to delete, then click the `•••` menu icon. Click on **Delete** to show the confirmation modal.

Click **Delete** to delete the component.