{"record":{"id":"cbcfb2b346198da3","repo":"spree/spree","slug":"spree-queues-taxons-is-deprecated-and-will-be-remo","errorCode":null,"errorMessage":"Spree.queues.taxons is deprecated and will be removed in Spree 6.1. Use Spree.queues.categories instead.","messagePattern":"Spree\\.queues\\.taxons is deprecated and will be removed in Spree 6\\.1\\. Use Spree\\.queues\\.categories instead\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"spree/core/lib/spree/core.rb","lineNumber":130,"sourceCode":"      reports: :default,\n      variants: :default,\n      categories: :default,\n      collections: :default,\n      stock_location_stock_levels: :default,\n      coupon_codes: :default,\n      themes: :default,\n      addresses: :default,\n      gift_cards: :default,\n      webhooks: :default,\n      payment_webhooks: :default,\n      api_keys: :default,\n      search: :default,\n      stock_reservations: :default,\n      tax_identifiers: :default\n    ).tap do |queues|\n      # @deprecated The taxons queue was renamed to categories in 6.0; removed in 6.1.\n      queues.define_singleton_method(:taxons) do\n        Spree::Deprecation.warn('Spree.queues.taxons is deprecated and will be removed in Spree 6.1. Use Spree.queues.categories instead.') if defined?(Spree::Deprecation)\n        categories\n      end\n\n      # @deprecated Renamed with the stock level rename in 6.0; removed in 6.1.\n      #\n      # The writer matters as much as the reader here: this is an OpenStruct, so\n      # an existing initializer assigning the old name would quietly define a\n      # field nobody reads and its jobs would fall back to the default queue.\n      queues.define_singleton_method(:stock_location_stock_items) do\n        Spree::Deprecation.warn('Spree.queues.stock_location_stock_items is deprecated and will be removed in Spree 6.1. Use Spree.queues.stock_location_stock_levels instead.') if defined?(Spree::Deprecation)\n        stock_location_stock_levels\n      end\n\n      queues.define_singleton_method(:stock_location_stock_items=) do |value|\n        Spree::Deprecation.warn('Spree.queues.stock_location_stock_items= is deprecated and will be removed in Spree 6.1. Use Spree.queues.stock_location_stock_levels= instead.') if defined?(Spree::Deprecation)\n        self.stock_location_stock_levels = value\n      end\n    end","sourceCodeStart":112,"sourceCodeEnd":148,"githubUrl":"https://github.com/spree/spree/blob/06bf66a8684b9de03210bbb2ddc8c1f5ba522fa2/spree/core/lib/spree/core.rb#L112-L148","documentation":"Spree 6.0 renamed Taxon to Category, and the Solid Queue config registry Spree.queues renamed its :taxons queue to :categories. The old reader survives for one release as a singleton method on the queues object: it warns, then returns the categories queue. It is removed in Spree 6.1.","triggerScenarios":"Reading Spree.queues.taxons - typically in an initializer configuring queue names (Spree.queues.taxons = 'custom') or in code that derives Solid Queue queue names for category-related jobs. The read warns every time.","commonSituations":"Host apps with 5.x-era queue configuration initializers; ops tooling or dashboards that enumerate Spree.queues; extensions registering category jobs under the old queue name.","solutions":["Use Spree.queues.categories for both reading and writing","Sweep: grep -rn 'queues.taxons' config lib app","Align Solid Queue config (config/queue.rb, queue namespaces) with the new queue name so jobs land in the intended queue","Run the suite with deprecations raised so stale reads surface as failures"],"exampleFix":"# before\nSpree.queues.taxons = 'spree_catalog'\n\n# after\nSpree.queues.categories = 'spree_catalog'","handlingStrategy":"validation","validationCode":"grep -rn 'queues\\.taxons' config lib app && echo 'PORT NEEDED' || echo 'clean'","typeGuard":null,"tryCatchPattern":null,"preventionTips":["After renaming a queue, verify jobs actually land on it in Solid Queue's dashboard before shipping","Keep all Spree.queues assignments in one initializer block for a single-port audit","Raise deprecations in test"],"tags":["deprecation","rename","queues","solid-queue","categories","spree-6-1"],"backgroundTag":"deprecated-api-usage","analyzedSha":"06bf66a8684b9de03210bbb2ddc8c1f5ba522fa2","analyzedAt":"2026-08-21T14:59:48.125Z","schemaVersion":2},"datasetVersion":"2026-08-21T18:17:14.833Z"}