diff --git a/src/SharpFM.Model/FolderData.cs b/src/SharpFM.Model/FolderData.cs
new file mode 100644
index 0000000..7b22b0b
--- /dev/null
+++ b/src/SharpFM.Model/FolderData.cs
@@ -0,0 +1,35 @@
+using System.Collections.Generic;
+
+namespace SharpFM.Model;
+
+///
+/// Data transfer object for folder-metadata persistence. Carries the FileMaker
+/// <Group> attributes that have no home on individual
+/// entries. An entry exists for every folder the user
+/// has materialized — including empty folders that contain no clips.
+///
+///
+/// Hierarchy this folder lives at, as an ordered list of segment names. The
+/// final segment is the folder's own name. Empty paths are not valid.
+///
+public sealed record FolderData(IReadOnlyList Path)
+{
+ ///
+ /// FileMaker Group/@id, preserved when the folder came from a paste.
+ /// Null for folders the user created locally; the host assigns an id when
+ /// the folder is copied back to FileMaker.
+ ///
+ public int? Id { get; init; }
+
+ ///
+ /// FileMaker Group/@includeInMenu. Defaults to true, matching
+ /// FileMaker's default for new groups.
+ ///
+ public bool IncludeInMenu { get; init; } = true;
+
+ ///
+ /// FileMaker Group/@groupCollapsed. Defaults to false; the UI
+ /// uses this to pre-collapse a pasted group on load.
+ ///
+ public bool GroupCollapsed { get; init; }
+}
diff --git a/src/SharpFM.Model/GroupPasteDecomposer.cs b/src/SharpFM.Model/GroupPasteDecomposer.cs
new file mode 100644
index 0000000..69baeeb
--- /dev/null
+++ b/src/SharpFM.Model/GroupPasteDecomposer.cs
@@ -0,0 +1,124 @@
+using System.Collections.Generic;
+using System.Xml;
+using System.Xml.Linq;
+
+namespace SharpFM.Model;
+
+///
+/// One script extracted from a FileMaker Group paste, paired with the folder
+/// path it should land in. is a full <fmxmlsnippet>
+/// envelope wrapping a single <Script>, ready to be re-pasted back
+/// to FileMaker as a single clip.
+///
+public sealed record GroupPasteEntry(string Name, string Xml, IReadOnlyList FolderPath);
+
+///
+/// Decomposed view of an fmxmlsnippet Group paste: the per-script
+/// entries plus folder metadata captured from every enclosing
+/// <Group>.
+///
+public sealed record GroupPasteResult(
+ IReadOnlyList Entries,
+ IReadOnlyList Folders);
+
+///
+/// Decomposes a FileMaker script-folder paste (an fmxmlsnippet whose
+/// root contains <Group> elements) into one entry per
+/// <Script>, preserving the Group hierarchy as
+/// and the Group attributes as
+/// .
+///
+public static class GroupPasteDecomposer
+{
+ ///
+ /// Returns the entries and folder metadata when the snippet contains any
+ /// <Group> at the top level, or null when the snippet
+ /// is a plain single-clip paste. Scripts that sit at the root alongside a
+ /// Group are emitted with an empty
+ /// so the caller can place them at the paste root.
+ ///
+ public static GroupPasteResult? TryDecompose(string xml)
+ {
+ XDocument doc;
+ try
+ {
+ doc = XDocument.Parse(xml);
+ }
+ catch (XmlException)
+ {
+ return null;
+ }
+
+ var root = doc.Root;
+ if (root is null) return null;
+
+ var hasGroup = false;
+ foreach (var _ in root.Elements("Group")) { hasGroup = true; break; }
+ if (!hasGroup) return null;
+
+ var entries = new List();
+ var folders = new List();
+ Walk(root, new List(), entries, folders);
+ return new GroupPasteResult(entries, folders);
+ }
+
+ private static void Walk(
+ XElement parent,
+ List folderPath,
+ List entries,
+ List folders)
+ {
+ foreach (var child in parent.Elements())
+ {
+ switch (child.Name.LocalName)
+ {
+ case "Script":
+ entries.Add(BuildEntry(child, folderPath));
+ break;
+ case "Group":
+ var name = child.Attribute("name")?.Value ?? "Group";
+ folderPath.Add(name);
+ folders.Add(BuildFolder(child, folderPath));
+ Walk(child, folderPath, entries, folders);
+ folderPath.RemoveAt(folderPath.Count - 1);
+ break;
+ }
+ }
+ }
+
+ private static GroupPasteEntry BuildEntry(XElement script, List folderPath)
+ {
+ var name = script.Attribute("name")?.Value;
+ if (string.IsNullOrEmpty(name)) name = "new-clip";
+
+ var snippet = new XElement("fmxmlsnippet",
+ new XAttribute("type", "FMObjectList"),
+ new XElement(script));
+
+ var xml = new XDocument(snippet).ToString(SaveOptions.DisableFormatting);
+
+ return new GroupPasteEntry(name, xml, folderPath.ToArray());
+ }
+
+ private static FolderData BuildFolder(XElement group, List folderPath)
+ {
+ int? id = null;
+ if (int.TryParse(group.Attribute("id")?.Value, out var parsedId))
+ {
+ id = parsedId;
+ }
+
+ return new FolderData(folderPath.ToArray())
+ {
+ Id = id,
+ IncludeInMenu = ParseFmBool(group.Attribute("includeInMenu"), defaultValue: true),
+ GroupCollapsed = ParseFmBool(group.Attribute("groupCollapsed"), defaultValue: false),
+ };
+ }
+
+ private static bool ParseFmBool(XAttribute? attribute, bool defaultValue)
+ {
+ if (attribute is null) return defaultValue;
+ return string.Equals(attribute.Value, "True", System.StringComparison.OrdinalIgnoreCase);
+ }
+}
diff --git a/src/SharpFM.Model/IClipRepository.cs b/src/SharpFM.Model/IClipRepository.cs
index b17808c..06f1f76 100644
--- a/src/SharpFM.Model/IClipRepository.cs
+++ b/src/SharpFM.Model/IClipRepository.cs
@@ -36,6 +36,22 @@ public interface IClipRepository
///
Task SaveClipsAsync(IReadOnlyList clips);
+ ///
+ /// Load folder metadata records — one per materialized folder (including
+ /// empty ones). Default implementation returns an empty list for backends
+ /// that don't model folders independently of clip paths.
+ ///
+ Task> LoadFoldersAsync() =>
+ Task.FromResult>([]);
+
+ ///
+ /// Save folder metadata. The implementation should handle creates,
+ /// updates, and deletes (folders not in the list should be removed).
+ /// Default implementation is a no-op for backends that infer folders from
+ /// clip paths only.
+ ///
+ Task SaveFoldersAsync(IReadOnlyList folders) => Task.CompletedTask;
+
///
/// Open a location picker and switch to the selected location.
/// Only called if is true.
diff --git a/src/SharpFM/MainWindow.axaml b/src/SharpFM/MainWindow.axaml
index 9683ebc..52fa61f 100644
--- a/src/SharpFM/MainWindow.axaml
+++ b/src/SharpFM/MainWindow.axaml
@@ -35,12 +35,14 @@