Reusing Design Elements using the Snippets Panel in Altium Designer

 

The Snippets panel is the central point for saving, reusing and managing design Snippets.

Summary

The Snippets panel provides a simple and easy way to save and reuse sections of design circuitry or code. Saved Snippets can be added into any design without having to start from scratch each time. The Snippets system lets you save any selection of:

  • Circuitry on a single schematic sheet.
  • Circuitry in a PCB design, including the components and the routing.
  • Code from within one of Altium Designer's code-aware editors.

The Snippets feature, accessed though the Snippets panel, is great for those often-used fragments and smaller sections of circuitry that you want to reuse. For larger, more standalone circuits that you wish to reuse in multiple designs – for example, power regulation circuits, USB interface circuitry, and so on – take a look at Altium Designer's support for Device Sheets.

Panel Access

The Snippets panel is accessed by clicking the System tab (located on the bottom right-hand side of the main design window), then select Snippets from the pop-up menu. You can also access the panel by clicking View » Workspace Panels » System » Snippets.

Snippet Organization

The Snippets panel allows snippets to be organized into folders so that related snippets can be grouped together, making it easier for the user to find. There are two types of folders in the Snippets system:

  • Snippets Folders – these are existing Windows folders that can contain both Snippets and one or more sub-folders of Snippets. These top-level folders cannot be created from within the Snippets panel. Instead, they are 'opened' or 'closed' with respect to browsing the Snippets they contain. These folders can only be created directly on your hard disk or network outside of Altium Designer.
  • Sub-Folders – these are lower-level folders used to organize snippets in a more logical and structured way. They can be readily created (and deleted) from within the Snippets panel or directly within an existing folder on your hard disk or network.

Adding and Removing Snippets Folders

Top-level snippets folders are opened and closed from the Available Snippets Folders dialog. Access this dialog by clicking the Snippets Folders button (top-right of the Snippets panel) or by right-clicking within the panel and choosing Add » Snippets Folder.

Control which top-level folders of Snippets are made available for use within Altium Designer.

Click Open Folder to browse to the required folder on your hard disk or network. The selected folder will be added to the list in the dialog and subsequently appear within the Snippets panel.

To remove a top-level snippets folder from the list (which is essentially closing it from a browsing perspective), select that folder in the list and click Remove Folder. You can also right-click on the folder in the Snippets panel and choose Remove » Close Snippets Folder. Use the Move Up and Move Down buttons to change the order in which the top-level folders will be presented in the Snippets panel.

Adding and Removing Sub-Folders

To add a new sub-folder to the overall Snippets structure, right-click within the Snippets panel and choose Add » Create New Folder. The Folder Properties dialog will appear from where you can specify a name for the new folder and determine under which parent folder it is to be created.

A sub-folder can be renamed and moved under a different 'parent' folder at any time by right-clicking on the folder in the Snippets panel and selecting Properties. To delete a sub-folder, right-click on its entry in the panel and choose Remove » Delete Folder.

The recommended way to add, move or delete sub-folders is from within the Snippets panel so that the change is immediately reflected in the panel. If you add, move or delete folders using Windows, the update will not be reflected in the panel until you close and restart Altium Designer.

Creating Snippets

To store a Snippet in the Snippets panel, select the required circuitry on the schematic or PCB editor or code within a code-aware editor, then right-click and choose Snippets » Create Snippet from selected objects from the context menu. A Snippet can also be created from within the Snippets panel - with the object(s)/code selected in the editor, right-click in the Snippets panel and choose Create Snippet from Selection.

Example of creating a snippet from a schematic circuit fragment.

The Add New Snippet dialog opens. Use this dialog to define a name for the snippet, in which folder it should be stored, as well as any descriptive comment which describes the circuit or code fragment.

Define properties of the new snippet as required.

Once saved, the snippet will be created and subsequently displayed in the Snippets panel. Note that the name, folder location and comment for a snippet can be changed at any time from the Snippet Properties dialog – accessed by right-clicking on the Snippet entry in the panel and choosing Properties from the context menu.

Each snippet is stored in a standard schematic, PCB or code-based (e.g., *.vhd) file. Upon creation, several other files are also created (*.Snippet, *.SnippetIcon, *.SnippetThumbnail). An indexing file is also present for each Snippet folder to keep track of the Snippets it contains.

Placing Snippets

To place a Snippet in a design, select its entry in the Snippets panel and click the Place Snippet button at the top of the panel. You can also right-click on the entry for the Snippet and choose Place Snippet from the context menu.

Place a reusable fragment of circuit or code into your design from the Snippets panel.

Ensure you have the correct target document open as the active document before placing the Snippet. The place command/button will only be available if the Snippet can correctly be placed on that document - that is, the Snippet type and document type must be the same.

Deleting Snippets

To delete a Snippet, right-click on its entry in the Snippets panel and choose Delete Snippet.

To delete all Snippets in a particular folder, right-click on that folder and choose Remove » Clear Folder.

Right-click Menus

Right-click in the Snippets panel to access the following options and commands:

  • Place Snippet (available when a snippet is selected) - place the selected snippet in the design workspace.
  • Delete Snippet (available when a snippet is selected) - delete the selected snippet.
  • Add - create a new folder under the parent folder or add an existing Snippets folder to those available in the panel.
  • Remove - clear the contents of a folder or delete the folder itself.
  • Sort - sort the panel's folder/snippet listing by date/type/name and set the folder/details visibility.
  • Show Thumbnails - select Snippets to be displayed in thumbnail or icon form. In the icon state, a Snippet's comment is not displayed in the panel.
  • Properties - opens the Snippet Properties dialog to view or edit the properties of the selected snippet.

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Note

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Content