Snippets Panel

Now reading version 1.0. For the latest, read: Snippets Panel for version 4

Nexus message

This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.

 

Parent page: System & Environment Panels

The Snippets panel is the central point for saving, reusing, and managing design Snippets.
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 NEXUS's code-aware editors.

The Snippets feature is great for those often-used fragments and smaller sections of circuitry that you want to reuse. 

Panel Access

The Snippets panel is accessed by clicking the Panels tab (located on the bottom right-hand side of the main design window), then selecting Snippets from the pop-up menu. You can also access the panel by clicking View » Panels » 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 you 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 NEXUS.
  • 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. This dialog is accessed by clicking the Snippets Folders button at the top-right of the Snippets panel or by right-clicking within the panel and choosing Add » Snippets Folder.

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 the folder in the list then click Remove Folder. You also can right-click on the folder in the Snippets panel then 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 then choose Add » Create New Folder. The Folder Properties dialog opens in which 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 then selecting Properties. To delete a sub-folder, right-click on its entry in the panel then 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 NEXUS.

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 in the following way: with the object(s)/code selected in the editor, right-click in the Snippets panel then choose Create Snippet From Selection.

Examples of creating a snippet from a schematic and from the Snippets panel.    Examples of creating a snippet from a schematic and from the Snippets panel.

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

Define properties of the new snippet as required.
Define properties of the new snippet as required.

Once saved, the snippet will be created and will be 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, which is accessed by right-clicking on the Snippet entry in the panel then 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 also can right-click on the entry for the Snippet and choose Place Snippet from the context menu.

Placing a Snippet from the Snippets panel.Placing a Snippet 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, i.e., 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 then choose Delete Snippet.

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

Right-click Menu

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

  • Create Snippet From Selection (available when a desired object(s) is selected) - use to store a Snippet in the panel.
  • 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, By Document Type, or By Document. Use Show Details and Show Folders to toggle the visibility of the Snippet folders and details.
  • Show Thumbnails - select Snippets to be displayed in thumbnail or icon form. In the icon state, Snippet comments are 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.
Content