{"record":{"id":"cdaa10deb7143c5c","repo":"octobercms/october","slug":"unable-to-find-content-fieldset-definition-with-uu-cdaa10","errorCode":null,"errorMessage":"Unable to find content fieldset definition with UUID of '{$this->blueprint_uuid}'.","messagePattern":"Unable to find content fieldset definition with UUID of '(.+?)'\\.","errorType":"exception","errorClass":"SystemException","httpStatus":null,"severity":"error","filePath":"modules/tailor/traits/BlueprintModel.php","lineNumber":69,"sourceCode":"        }\n\n        $blueprint = BlueprintIndexer::instance()->find($uuid);\n        if (!$blueprint) {\n            throw new SystemException(sprintf('Unable to find import/export blueprint with ID \"%s\".', $uuid));\n        }\n\n        return $this->blueprintCache = $blueprint;\n    }\n\n    /**\n     * getContentFieldsetDefinition\n     */\n    public function getContentFieldsetDefinition(): Fieldset\n    {\n        $fieldset = BlueprintIndexer::instance()->findContentFieldset($this->blueprint_uuid);\n\n        if (!$fieldset) {\n            throw new SystemException(\"Unable to find content fieldset definition with UUID of '{$this->blueprint_uuid}'.\");\n        }\n\n        return $fieldset;\n    }\n\n    /**\n     * isEntryStructure\n     */\n    public function isEntryStructure(): bool\n    {\n        return $this->getBlueprintDefinition() instanceof StructureBlueprint;\n    }\n\n    /**\n     * resolveBlueprintModel\n     */\n    protected function resolveBlueprintModel()\n    {","sourceCodeStart":51,"sourceCodeEnd":87,"githubUrl":"https://github.com/octobercms/october/blob/b608633a7e8922487d91a8161499020121c3b3bf/modules/tailor/traits/BlueprintModel.php#L51-L87","documentation":"Thrown by BlueprintModel's getContentFieldsetDefinition() when BlueprintIndexer::findContentFieldset($this->blueprint_uuid) returns null — no content fieldset is registered for the model's blueprint UUID. Import/export models rely on the content fieldset to know which fields to import or export, so a missing fieldset aborts with a SystemException.","triggerScenarios":"Calling getContentFieldsetDefinition() on an import/export model whose blueprint_uuid is null or references a blueprint without content fields; blueprints whose fieldset content was never synced; blueprints with no fields defined at all may also fail to produce a content fieldset.","commonSituations":"Fresh environments where tailor:sync was not run; blueprint UUID drift after deletion/recreation; importing against a blueprint whose content fields were removed or restructured without a re-sync.","solutions":["Run php artisan tailor:sync and php artisan cache:clear to register content fieldsets","Verify the blueprint actually defines content fields under its fields: section; add at least one field if it is empty","Confirm the model's blueprint_uuid matches an existing blueprint (see error 755 fixes)"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"// Check the content fieldset exists before importing\n$fieldset = \\Tailor\\Classes\\BlueprintIndexer::instance()->findContentFieldset($model->blueprint_uuid);\nif (!$fieldset) {\n    // sync blueprints or abort with an actionable message\n}","typeGuard":"function contentFieldsetExists(?string $uuid): bool\n{\n    return $uuid !== null\n        && \\Tailor\\Classes\\BlueprintIndexer::instance()->findContentFieldset($uuid) !== null;\n}","tryCatchPattern":null,"preventionTips":["Ensure target blueprints define at least one content field before building importers against them","Run tailor:sync after any blueprint field changes and before running imports","Clear the blueprint cache (php artisan cache:clear) after syncing in production"],"tags":["tailor","octobercms","blueprint","fieldset","import-export","uuid","indexer"],"backgroundTag":"missing-fieldset-definition","analyzedSha":"b608633a7e8922487d91a8161499020121c3b3bf","analyzedAt":"2026-08-21T04:24:57.515Z","schemaVersion":2},"datasetVersion":"2026-08-21T11:28:35.574Z"}