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

# ETL: Package Designer

> Use the Integrate.io ETL package designer to build and configure data pipelines visually. Edit package name, description, and component layout.

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/creating-packages/working-in-the-new-package-designer/image-1.png?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=b0cec520ec5c9f39e74b2238fe1895f9" alt="Package name and description fields in the designer" width="1128" height="610" data-path="images/creating-packages/working-in-the-new-package-designer/image-1.png" />
</Frame>

<Steps>
  <Step>
    Click the package name.
  </Step>

  <Step>
    In the **Package name** text box, type a new name.
  </Step>

  <Step>
    In the **Package description** text box, type a new name.
  </Step>
</Steps>

## To add a note

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/creating-packages/working-in-the-new-package-designer/image-2.png?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=d3c0ef5bb3e2c0c1792e94f5403b1a51" alt="New note icon and editable note on the designer canvas" width="1007" height="668" data-path="images/creating-packages/working-in-the-new-package-designer/image-2.png" />
</Frame>

<Steps>
  <Step>
    Click the new note icon. A note appears.
  </Step>

  <Step>
    To edit the note, click it and enter text.
  </Step>

  <Step>
    To color-code the note, select a color from the swatch row at the top of the note editor. The available colors are yellow, blue, green, red, purple, and gray. New notes default to yellow.

    Use colors to group notes by purpose, such as marking priorities or distinguishing source, transformation, and destination annotations.
  </Step>

  <Step>
    Click **done** to save the note. The selected color applies to the note on the canvas and on the minimap, and persists when you save and reload the package.
  </Step>

  <Step>
    You can add as many notes as you require.
  </Step>
</Steps>

The note name appears in a tooltip on hover, so meaning never depends on color alone.

## After you have added at least one source\ task component, you can perform the following actions on the package and components:

* To open a component for editing - click the component.

  <Frame>
    <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/creating-packages/working-in-the-new-package-designer/image-3.png?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=32261de5611719a0287c2a6aa3115b9a" alt="Clicking a component to open it for editing" width="1123" height="761" data-path="images/creating-packages/working-in-the-new-package-designer/image-3.png" />
  </Frame>

* To add a component to a package - click the blue connector under an existing component, or click **+ Add Component**.

  <Frame>
    <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/creating-packages/working-in-the-new-package-designer/image-4.png?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=6a287cfef0d83c2d45816cdc774065a7" alt="Blue connector and Add Component button below a component" width="1008" height="670" data-path="images/creating-packages/working-in-the-new-package-designer/image-4.png" />
  </Frame>

* To delete a component - hover on the component until the red delete icon appears on the component, then click the red delete icon.

  <Frame>
    <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/creating-packages/working-in-the-new-package-designer/image-5.png?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=61fd0ededf78a02750f96674e104347e" alt="Red delete icon appearing on component hover" width="592" height="507" data-path="images/creating-packages/working-in-the-new-package-designer/image-5.png" />
  </Frame>

* To duplicate a component - hover on the component until the black duplicate icon appears on the component, then click the black duplicate icon.

  <Frame>
    <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/creating-packages/working-in-the-new-package-designer/image-6.png?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=d18028aaefd301ba76340459e5191de7" alt="Black duplicate icon appearing on component hover" width="843" height="529" data-path="images/creating-packages/working-in-the-new-package-designer/image-6.png" />
  </Frame>

* To cut the dataflow between components - click the disconnect icon on the hover on the dotted line near a component, then click disconnect.

* To connect a dataflow between two components - drag the blue connector on the first connector and drop it on the target connector.

## To copy components to the same or a different package

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/creating-packages/working-in-the-new-package-designer/image-7.png?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=eace30ba4c4d33d5915e5272d28bb96c" alt="Selecting and copying multiple components on the canvas" width="965" height="527" data-path="images/creating-packages/working-in-the-new-package-designer/image-7.png" />
</Frame>

<Steps>
  <Step>
    Select the component(s) to copy using any of the following methods:

    * Click an empty space on the canvas, and drag to select the required component(s).
      * Select all the components in the package by clicking **select** and then clicking **All** (to unselect components, click **None**).
      * Select only components that are connected to each other by clicking **select** and then clicking **Connected**.
  </Step>

  <Step>
    Press **Ctrl+C** (on a Mac, press **Cmd+C**).
  </Step>

  <Step>
    Open the required package and press **Ctrl+V** (on a Mac, press Cmd+V).
  </Step>
</Steps>

## To modify a component's name:

<Steps>
  <Step>
    Click the component.
  </Step>

  <Step>
    In the first text box in the component, type a new name.
  </Step>
</Steps>

## To add or edit a component description:

Every source, transformation, and destination component supports an optional free-text description shown under the component name. Use it to record what a component does or any caveats other package authors should know.

<Steps>
  <Step>
    Open the component for editing.
  </Step>

  <Step>
    Under the component name, click **Add description**.
  </Step>

  <Step>
    Type your description in the textarea (up to 500 characters), then click outside the textarea to save.
  </Step>

  <Step>
    To change an existing description, click the pencil icon next to the description text.
  </Step>
</Steps>

The description is saved with the component and persists when you save the package and reload it. Notes use their own editor and do not have a separate description field.

## To undo / redo your last changes to a package

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/creating-packages/working-in-the-new-package-designer/image-8.png?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=3ed7d548e16d8c01169146cd704c0a52" alt="Undo and redo arrow icons in the designer toolbar" width="1131" height="660" data-path="images/creating-packages/working-in-the-new-package-designer/image-8.png" />
</Frame>

<Steps>
  <Step>
    Click the undo / redo arrow icon.
  </Step>
</Steps>

## To use the expression editor in a component field:

<Frame>
  <img src="https://mintcdn.com/integrateio/HSGmKiO3soPLENmi/images/creating-packages/working-in-the-new-package-designer/image-9.png?fit=max&auto=format&n=HSGmKiO3soPLENmi&q=85&s=658b8ee683c435170f900bdeb7eb050d" alt="Expression editor with auto-complete showing functions and fields" width="1131" height="660" data-path="images/creating-packages/working-in-the-new-package-designer/image-9.png" />
</Frame>

<Steps>
  <Step>
    Open the required component.
  </Step>

  <Step>
    Click the edit icon on the field.
  </Step>

  <Step>
    To activate auto-complete, press **Ctrl+SPACEBAR**. A list of field names (available in this component), functions and data types appears. Scroll to the required item and click to add it to the expression.
  </Step>
</Steps>

## To change the order of fields in a component:

<Steps>
  <Step>
    Click and drag the arrow located to the left of the field up or down to the new position.
  </Step>
</Steps>
