Content Link - Remove Link

Removes the link from its owning Batch Folder.

Remarks

The Remove Link command is used to detach a Content Link from its associated external content, such as a file, document, or repository object. This operation is essential for managing the lifecycle of linked content in Grooper, especially when documents are deleted, moved, or no longer need to reference external storage.

When to Use

• Use this command when you want to permanently remove the association between a Batch Folder and its external content.
• It is commonly used during cleanup, archival, or when preparing to re-import or replace content.
• Removing a link does not delete the external content itself, but only the reference within Grooper.

How It Works

• When executed, the command removes the selected Content Link from the parent Batch Folder.
• If the link references a "sparse" document (where only a link is stored and content is loaded on demand), you can optionally load and import the content into Grooper before removing the link by enabling the 'Load If Sparse' property.
• This ensures that the document remains accessible in Grooper even after the external reference is removed.

Usage Guidance

• The command is available from the context menu or property grid for Content Link objects.
• Review the 'Load If Sparse' setting to determine whether to preserve the content in Grooper before unlinking.
• After removal, the Batch Folder will no longer reference the external content, and any associated metadata or properties will be cleared.

> Tip: Use this command to manage the transition from linked (external) to embedded (internal) content, or to clean up obsolete or broken links in your batch structure.

Properties

Name	Type		Description
Load If Sparse	Boolean	►	When set to True, specifies that sparse documents should be loaded before the link is removed. DefaultFalse The 'Load If Sparse' property controls whether Grooper should import the content of a "sparse" document before removing the Content Link. A sparse document is one where only a link to external content is stored, and the actual file or document is loaded on demand. When to Enable Enable this property if you want to preserve the content in Grooper after unlinking, ensuring that the document remains accessible even if the external source is deleted or becomes unavailable. This is especially important for long-term retention, archival, or when migrating documents from external storage into the Grooper repository. Configuration Guidance Set to True to automatically load and import the content before removing the link. Set to False to remove the link without importing the content. The document will no longer be accessible in Grooper unless another link or attachment exists. Example > If you have imported documents using the "sparse import" option and now wish to make them fully local to Grooper, > enable 'Load If Sparse' before removing the link. This will ensure the content is copied into the batch and > remains available for processing, review, or export. > Note: If the document is not sparse, or if the content is already present in Grooper, this property has no effect.

See Also

Content Link