siyuan-note/siyuan · error

invalid create attribute view item documents save mode [%s]

Error message

invalid create attribute view item documents save mode [%s]

What it means

Error "invalid create attribute view item documents save mode [%s]" thrown in siyuan-note/siyuan.

Source

Thrown at kernel/model/attribute_view_new_item.go:327

	lock.Lock()
	return lock.Unlock
}

func attributeViewItemDocumentTemplate(attrView *av.AttributeView, saveMode string) (*av.NewItemTemplate, error) {
	switch saveMode {
	case CreateAttributeViewItemDocsSaveModeSubDoc:
		return &av.NewItemTemplate{
			TargetType:   av.NewItemTargetDocument,
			SaveLocation: &av.NewItemSaveLocation{},
		}, nil
	case CreateAttributeViewItemDocsSaveModeTemplate:
		itemTemplate := attrView.GetNewItemTemplate(attrView.DefaultTemplateID)
		if nil != itemTemplate && av.NewItemTargetDocument == itemTemplate.TargetType {
			return itemTemplate, nil
		}
		return &av.NewItemTemplate{TargetType: av.NewItemTargetDocument}, nil
	default:
		return nil, fmt.Errorf("invalid create attribute view item documents save mode [%s]", saveMode)
	}
}

func resolveAttributeViewNewItemTemplate(blockID string, itemTemplate *av.NewItemTemplate, createdAt time.Time) (*NewItemTemplatePreview, error) {
	boxID := ""
	if blockTree := treenode.GetBlockTree(blockID); blockTree != nil {
		boxID = blockTree.BoxID
	} else {
		for _, encBoxID := range treenode.GetOpenedEncryptedBoxIDs() {
			if blockTree := treenode.GetBlockTreeInBox(blockID, encBoxID); blockTree != nil {
				boxID = encBoxID
				break
			}
		}
	}
	primary, err := RenderGoTemplateAtInBox(itemTemplate.PrimaryKeyTemplate, createdAt, boxID)
	if nil != err {
		return nil, err

View on GitHub (pinned to 251596fc0d)

Solutions

1. Use a supported save mode value for creating item documents (for example the documented current-notebook or specified-path modes).
2. Check the API parameter spelling against the attribute view new-item documentation.

Example fix

Pass saveMode with a valid enum value accepted by addAttributeViewItem instead of a custom string.

When it happens

Trigger: Calling the create-item API with an unrecognized save-mode option for where the new row's document should be stored.

Common situations: Occurs when the client passes an unsupported save mode for documents created from an attribute view new-item template.

AI-assisted analysis of siyuan-note/siyuan@251596fc0d (2026-08-12). Data as JSON: /api/errors/3ca0917a2d06edc0. Report an issue: GitHub.