From e83891e3cab6fd5cec648f33773253b627e45b0d Mon Sep 17 00:00:00 2001
From: Gtt1229 <gman1229@gmail.com>
Date: Fri, 30 Jan 2026 12:18:15 -0500
Subject: [PATCH] feat: Added Option to Import Recipe Category During Recipe
 Import (#6523)

Co-authored-by: Michael Genson <genson.michael@gmail.com>
Co-authored-by: Michael Genson <71845777+michael-genson@users.noreply.github.com>
---
 .../composables/use-new-recipe-options.ts     | 15 +++++++++
 frontend/composables/use-users/preferences.ts |  2 ++
 frontend/lang/messages/en-US.json             |  1 +
 frontend/lib/api/user/recipes/recipe.ts       |  8 ++---
 .../pages/g/[groupSlug]/r/create/html.vue     | 14 ++++++--
 frontend/pages/g/[groupSlug]/r/create/url.vue | 14 ++++++--
 mealie/routes/recipe/recipe_crud_routes.py    |  5 +++
 mealie/schema/recipe/recipe_scraper.py        |  2 ++
 mealie/services/scraper/cleaner.py            |  4 +--
 mealie/services/scraper/scraped_extras.py     | 33 ++++++++++++++++++-
 mealie/services/scraper/scraper_strategies.py |  1 +
 11 files changed, 86 insertions(+), 13 deletions(-)

diff --git a/frontend/composables/use-new-recipe-options.ts b/frontend/composables/use-new-recipe-options.ts
index 0788cf0eb..6f01c2b5b 100644
--- a/frontend/composables/use-new-recipe-options.ts
+++ b/frontend/composables/use-new-recipe-options.ts
@@ -2,6 +2,7 @@ import { useRecipeCreatePreferences } from "~/composables/use-users/preferences"
 
 export interface UseNewRecipeOptionsProps {
   enableImportKeywords?: boolean;
+  enableImportCategories?: boolean;
   enableStayInEditMode?: boolean;
   enableParseRecipe?: boolean;
 }
@@ -9,6 +10,7 @@ export interface UseNewRecipeOptionsProps {
 export function useNewRecipeOptions(props: UseNewRecipeOptionsProps = {}) {
   const {
     enableImportKeywords = true,
+    enableImportCategories = true,
     enableStayInEditMode = true,
     enableParseRecipe = true,
   } = props;
@@ -27,6 +29,17 @@ export function useNewRecipeOptions(props: UseNewRecipeOptionsProps = {}) {
     },
   });
 
+  const importCategories = computed({
+    get() {
+      if (!enableImportCategories) return false;
+      return recipeCreatePreferences.value.importCategories;
+    },
+    set(v: boolean) {
+      if (!enableImportCategories) return;
+      recipeCreatePreferences.value.importCategories = v;
+    },
+  });
+
   const stayInEditMode = computed({
     get() {
       if (!enableStayInEditMode) return false;
@@ -71,6 +84,7 @@ export function useNewRecipeOptions(props: UseNewRecipeOptionsProps = {}) {
   return {
     // Computed properties for the checkboxes
     importKeywordsAsTags,
+    importCategories,
     stayInEditMode,
     parseRecipe,
 
@@ -79,6 +93,7 @@ export function useNewRecipeOptions(props: UseNewRecipeOptionsProps = {}) {
 
     // Props for conditional rendering
     enableImportKeywords,
+    enableImportCategories,
     enableStayInEditMode,
     enableParseRecipe,
   };
diff --git a/frontend/composables/use-users/preferences.ts b/frontend/composables/use-users/preferences.ts
index 46f4752b0..103678788 100644
--- a/frontend/composables/use-users/preferences.ts
+++ b/frontend/composables/use-users/preferences.ts
@@ -63,6 +63,7 @@ export interface UserRecipeFinderPreferences {
 
 export interface UserRecipeCreatePreferences {
   importKeywordsAsTags: boolean;
+  importCategories: boolean;
   stayInEditMode: boolean;
   parseRecipe: boolean;
 }
@@ -233,6 +234,7 @@ export function useRecipeCreatePreferences(): Ref<UserRecipeCreatePreferences> {
     "recipe-create-preferences",
     {
       importKeywordsAsTags: false,
+      importCategories: false,
       stayInEditMode: false,
       parseRecipe: true,
     },
diff --git a/frontend/lang/messages/en-US.json b/frontend/lang/messages/en-US.json
index 9e67a2adc..43d3b82e0 100644
--- a/frontend/lang/messages/en-US.json
+++ b/frontend/lang/messages/en-US.json
@@ -642,6 +642,7 @@
     "scrape-recipe-website-being-blocked": "Website being blocked?",
     "scrape-recipe-try-importing-raw-html-instead": "Try importing the raw HTML instead.",
     "import-original-keywords-as-tags": "Import original keywords as tags",
+    "import-original-categories": "Import original categories",
     "stay-in-edit-mode": "Stay in Edit mode",
     "parse-recipe-ingredients-after-import": "Parse recipe ingredients after import",
     "import-from-zip": "Import from Zip",
diff --git a/frontend/lib/api/user/recipes/recipe.ts b/frontend/lib/api/user/recipes/recipe.ts
index bc56a9591..abf398631 100644
--- a/frontend/lib/api/user/recipes/recipe.ts
+++ b/frontend/lib/api/user/recipes/recipe.ts
@@ -146,12 +146,12 @@ export class RecipeAPI extends BaseCRUDAPI<CreateRecipe, Recipe, Recipe> {
     return await this.requests.post<Recipe | null>(routes.recipesTestScrapeUrl, { url, useOpenAI });
   }
 
-  async createOneByHtmlOrJson(data: string, includeTags: boolean, url: string | null = null) {
-    return await this.requests.post<string>(routes.recipesCreateFromHtmlOrJson, { data, includeTags, url });
+  async createOneByHtmlOrJson(data: string, includeTags: boolean, includeCategories: boolean, url: string | null = null) {
+    return await this.requests.post<string>(routes.recipesCreateFromHtmlOrJson, { data, includeTags, includeCategories, url });
   }
 
-  async createOneByUrl(url: string, includeTags: boolean) {
-    return await this.requests.post<string>(routes.recipesCreateUrl, { url, includeTags });
+  async createOneByUrl(url: string, includeTags: boolean, includeCategories: boolean) {
+    return await this.requests.post<string>(routes.recipesCreateUrl, { url, includeTags, includeCategories });
   }
 
   async createManyByUrl(payload: CreateRecipeByUrlBulk) {
diff --git a/frontend/pages/g/[groupSlug]/r/create/html.vue b/frontend/pages/g/[groupSlug]/r/create/html.vue
index 5e0eccc5c..e358c7d42 100644
--- a/frontend/pages/g/[groupSlug]/r/create/html.vue
+++ b/frontend/pages/g/[groupSlug]/r/create/html.vue
@@ -1,7 +1,7 @@
 <template>
   <v-form
     ref="domUrlForm"
-    @submit.prevent="createFromHtmlOrJson(newRecipeData, importKeywordsAsTags, newRecipeUrl)"
+    @submit.prevent="createFromHtmlOrJson(newRecipeData, importKeywordsAsTags, importCategories, newRecipeUrl)"
   >
     <div>
       <v-card-title class="headline">
@@ -63,6 +63,12 @@
           hide-details
           :label="$t('recipe.import-original-keywords-as-tags')"
         />
+        <v-checkbox
+          v-model="importCategories"
+          color="primary"
+          hide-details
+          :label="$t('recipe.import-original-categories')"
+        />
         <v-checkbox
           v-model="stayInEditMode"
           color="primary"
@@ -116,6 +122,7 @@ export default defineNuxtComponent({
 
     const {
       importKeywordsAsTags,
+      importCategories,
       stayInEditMode,
       parseRecipe,
       navigateToRecipe,
@@ -160,7 +167,7 @@ export default defineNuxtComponent({
     }
     handleIsEditJson();
 
-    async function createFromHtmlOrJson(htmlOrJsonData: string | object | null, importKeywordsAsTags: boolean, url: string | null = null) {
+    async function createFromHtmlOrJson(htmlOrJsonData: string | object | null, importKeywordsAsTags: boolean, importCategories: boolean, url: string | null = null) {
       if (!htmlOrJsonData) {
         return;
       }
@@ -179,7 +186,7 @@ export default defineNuxtComponent({
       }
 
       state.loading = true;
-      const { response } = await api.recipes.createOneByHtmlOrJson(dataString, importKeywordsAsTags, url);
+      const { response } = await api.recipes.createOneByHtmlOrJson(dataString, importKeywordsAsTags, importCategories, url);
       handleResponse(response, importKeywordsAsTags);
     }
 
@@ -188,6 +195,7 @@ export default defineNuxtComponent({
       importKeywordsAsTags,
       stayInEditMode,
       parseRecipe,
+      importCategories,
       newRecipeData,
       newRecipeUrl,
       handleIsEditJson,
diff --git a/frontend/pages/g/[groupSlug]/r/create/url.vue b/frontend/pages/g/[groupSlug]/r/create/url.vue
index 88567e8e4..48ab4af6d 100644
--- a/frontend/pages/g/[groupSlug]/r/create/url.vue
+++ b/frontend/pages/g/[groupSlug]/r/create/url.vue
@@ -2,7 +2,7 @@
   <div>
     <v-form
       ref="domUrlForm"
-      @submit.prevent="createByUrl(recipeUrl, importKeywordsAsTags)"
+      @submit.prevent="createByUrl(recipeUrl, importKeywordsAsTags, importCategories)"
     >
       <div>
         <v-card-title class="headline">
@@ -38,6 +38,12 @@
           hide-details
           :label="$t('recipe.import-original-keywords-as-tags')"
         />
+        <v-checkbox
+          v-model="importCategories"
+          color="primary"
+          hide-details
+          :label="$t('recipe.import-original-categories')"
+        />
         <v-checkbox
           v-model="stayInEditMode"
           color="primary"
@@ -148,6 +154,7 @@ export default defineNuxtComponent({
 
     const {
       importKeywordsAsTags,
+      importCategories,
       stayInEditMode,
       parseRecipe,
       navigateToRecipe,
@@ -219,7 +226,7 @@ export default defineNuxtComponent({
       router.replace({ query: undefined }).then(() => router.push(to));
     });
 
-    async function createByUrl(url: string | null, importKeywordsAsTags: boolean) {
+    async function createByUrl(url: string | null, importKeywordsAsTags: boolean, importCategories: boolean) {
       if (url === null) {
         return;
       }
@@ -229,7 +236,7 @@ export default defineNuxtComponent({
         return;
       }
       state.loading = true;
-      const { response } = await api.recipes.createOneByUrl(url, importKeywordsAsTags);
+      const { response } = await api.recipes.createOneByUrl(url, importKeywordsAsTags, importCategories);
       handleResponse(response, importKeywordsAsTags);
     }
 
@@ -238,6 +245,7 @@ export default defineNuxtComponent({
       htmlOrJsonImporterTarget,
       recipeUrl,
       importKeywordsAsTags,
+      importCategories: importCategories,
       stayInEditMode,
       parseRecipe,
       domUrlForm,
diff --git a/mealie/routes/recipe/recipe_crud_routes.py b/mealie/routes/recipe/recipe_crud_routes.py
index 14c348ca4..becae3e0a 100644
--- a/mealie/routes/recipe/recipe_crud_routes.py
+++ b/mealie/routes/recipe/recipe_crud_routes.py
@@ -165,6 +165,11 @@ class RecipeController(BaseRecipeController):
 
             recipe.tags = extras.use_tags(ctx)  # type: ignore
 
+        if req.include_categories:
+            ctx = ScraperContext(self.repos)
+
+            recipe.recipe_category = extras.use_categories(ctx)  # type: ignore
+
         new_recipe = self.service.create_one(recipe)
 
         if new_recipe:
diff --git a/mealie/schema/recipe/recipe_scraper.py b/mealie/schema/recipe/recipe_scraper.py
index 1a9dc88f5..0500afca6 100644
--- a/mealie/schema/recipe/recipe_scraper.py
+++ b/mealie/schema/recipe/recipe_scraper.py
@@ -10,6 +10,7 @@ class ScrapeRecipeTest(MealieModel):
 
 class ScrapeRecipeBase(MealieModel):
     include_tags: bool = False
+    include_categories: bool = False
 
 
 class ScrapeRecipe(ScrapeRecipeBase):
@@ -19,6 +20,7 @@ class ScrapeRecipe(ScrapeRecipeBase):
             "example": {
                 "url": "https://myfavoriterecipes.com/recipes",
                 "includeTags": True,
+                "includeCategories": True,
             },
         }
     )
diff --git a/mealie/services/scraper/cleaner.py b/mealie/services/scraper/cleaner.py
index 88d635e1f..5b1a234ac 100644
--- a/mealie/services/scraper/cleaner.py
+++ b/mealie/services/scraper/cleaner.py
@@ -521,8 +521,8 @@ def clean_categories(category: str | list) -> list[str]:
         case str(category):
             if not category.strip():
                 return []
-
-            return [category]
+            # Split comma-separated categories
+            return [cat.strip().title() for cat in category.split(",") if cat.strip()]
         case [str(), *_]:
             return [cat.strip().title() for cat in category if cat.strip()]
         case [{"name": str(), "slug": str()}, *_]:
diff --git a/mealie/services/scraper/scraped_extras.py b/mealie/services/scraper/scraped_extras.py
index 121ab177a..2d3928694 100644
--- a/mealie/services/scraper/scraped_extras.py
+++ b/mealie/services/scraper/scraped_extras.py
@@ -4,7 +4,7 @@ from slugify import slugify
 
 from mealie.repos.repository_factory import AllRepositories
 from mealie.schema.recipe import TagOut
-from mealie.schema.recipe.recipe_category import TagSave
+from mealie.schema.recipe.recipe_category import CategorySave, TagSave
 
 
 class NoContextException(Exception):
@@ -19,10 +19,14 @@ class ScraperContext:
 class ScrapedExtras:
     def __init__(self) -> None:
         self._tags: list[str] = []
+        self._categories: list[str] = []
 
     def set_tags(self, tags: list[str]) -> None:
         self._tags = tags
 
+    def set_categories(self, categories: list[str]) -> None:
+        self._categories = categories
+
     def use_tags(self, ctx: ScraperContext) -> list[TagOut]:
         if not self._tags:
             return []
@@ -49,3 +53,30 @@ class ScrapedExtras:
             tags.append(db_tag)
 
         return tags
+
+    def use_categories(self, ctx: ScraperContext) -> list[TagOut]:
+        if not self._categories:
+            return []
+
+        repo = ctx.repos.categories
+
+        categories = []
+        seen_category_slugs: set[str] = set()
+        for category in self._categories:
+            slugify_category = slugify(category)
+            if slugify_category in seen_category_slugs:
+                continue
+
+            seen_category_slugs.add(slugify_category)
+
+            # Check if category exists
+            if db_category := repo.get_one(slugify_category, "slug"):
+                categories.append(db_category)
+                continue
+
+            save_data = CategorySave(name=category, group_id=ctx.repos.group_id)
+            db_category = repo.create(save_data)
+
+            categories.append(db_category)
+
+        return categories
diff --git a/mealie/services/scraper/scraper_strategies.py b/mealie/services/scraper/scraper_strategies.py
index 22129d16e..c2ebe9dcd 100644
--- a/mealie/services/scraper/scraper_strategies.py
+++ b/mealie/services/scraper/scraper_strategies.py
@@ -194,6 +194,7 @@ class RecipeScraperPackage(ABCScraperStrategy):
         extras = ScrapedExtras()
 
         extras.set_tags(try_get_default(scraped_data.keywords, "keywords", "", cleaner.clean_tags))
+        extras.set_categories(try_get_default(scraped_data.category, "recipeCategory", "", cleaner.clean_categories))
 
         recipe = Recipe(
             name=try_get_default(scraped_data.title, "name", "No Name Found", cleaner.clean_string),