\
**Category:** Questions\
**Tags:** catalog-api\
**Created:** [August 15, 2025, 7:01pm UTC](https://developer.squareup.com/forums/t/description-html-not-working/23682 "2025-08-15T19:01:49Z")\
**Posts on this page:** 7\
**Page:** 1
**Author:**  [@thehauntedbookshop](https://developer.squareup.com/forums/u/thehauntedbookshop)\
**Post date:** [August 15, 2025, 7:01pm UTC](https://developer.squareup.com/forums/t/description-html-not-working/23682/1 "2025-08-15T19:01:49Z")
I’d been using the **Upsert catalog object** just fine for years and hadn’t realized the description field had been deprecated. Only started investigating it because lately I noticed that anything added now just has the HTML code in the description when viewing it in Square. So I see that description\_html is now what we’re to use, which is fine. So I go into my code and add \_html to the preexisting field and now when the code runs it adds the catalog item but completely ignores the description field?
---
**Author:**  [@Square-Dev-AI](https://developer.squareup.com/forums/u/Square-Dev-AI)\
**Post date:** [August 15, 2025, 7:02pm UTC](https://developer.squareup.com/forums/t/description-html-not-working/23682/2 "2025-08-15T19:02:02Z")
👋 I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:
> **[Design a Catalog](https://developer.squareup.com/docs/catalog-api/design-a-catalog)**
>
> When designing a product catalog, learn where to draw the line between an item, item variation, and item modifier.
> **[Catalog API](https://developer.squareup.com/docs/catalog-api/what-it-does)**
>
> Learn about creating and managing a product catalog with the Square Catalog API.
> **Additional Documentation**
>
> [Synchronize a Catalog with an External Platform](https://developer.squareup.com/docs/catalog-api/sync-with-external-system)
> [Categorize Catalog Items](https://developer.squareup.com/docs/catalog-api/categorize-catalog-items)
> [Add a Catalog Item](https://developer.squareup.com/docs/catalog-api/build-with-catalog)
If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.
---
**Author:**  [@Bryan-Square](https://developer.squareup.com/forums/u/Bryan-Square)\
**Post date:** [August 15, 2025, 8:23pm UTC](https://developer.squareup.com/forums/t/description-html-not-working/23682/3 "2025-08-15T20:23:18Z")
What’s your application ID? 🙂
---
**Author:**  [@thehauntedbookshop](https://developer.squareup.com/forums/u/thehauntedbookshop)\
**Post date:** [August 15, 2025, 9:14pm UTC](https://developer.squareup.com/forums/t/description-html-not-working/23682/4 "2025-08-15T21:14:05Z")
sq0idp-Yrrrvui1jKbXT1NB5uizpQ
---
**Author:**  [@thehauntedbookshop](https://developer.squareup.com/forums/u/thehauntedbookshop)\
**Post date:** [August 30, 2025, 8:21pm UTC](https://developer.squareup.com/forums/t/description-html-not-working/23682/5 "2025-08-30T20:21:23Z")
Just checking in – Any luck?
---
**Author:**  [@thehauntedbookshop](https://developer.squareup.com/forums/u/thehauntedbookshop)\
**Post date:** [September 2, 2025, 5:29pm UTC](https://developer.squareup.com/forums/t/description-html-not-working/23682/7 "2025-09-02T17:29:24Z")
Thank you so much! It was in the right position, but it was the Square version that needed to be updated!
---
**Author:**  [@Bryan-Square](https://developer.squareup.com/forums/u/Bryan-Square)\
**Post date:** [September 2, 2025, 5:55pm UTC](https://developer.squareup.com/forums/t/description-html-not-working/23682/8 "2025-09-02T17:55:11Z")
Glad to hear that you figured it out and thank you for sharing your results. 🙂