> For the complete documentation index, see [llms.txt](https://help.accentuate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.accentuate.io/use-case-guides/home-and-living/room.md).

# Room

OVERVIEW  

The Room field captures the intended spatial context for a Home & Living product. It answers the first question every customer has: will this work in my space? A sofa belongs in the living room, a bath mat in the bathroom — but without structured Room data, search, filtering, and AI-driven recommendations cannot surface the right product to the right shopper.

This field does not describe the product's physical attributes. It describes the environment the product is designed for. A floor lamp might be physically usable anywhere, but if it is designed for bedside reading, the Room value should reflect that.

  BUSINESS VALUE  

Why this field matters

* Room is the primary filter on every major home & living marketplace and retailer website
* Customers browse by room before they browse by product type — 'bedroom accessories' before 'cushions'
* Structured Room data powers collection pages, navigation menus, and filtered search without manual curation
* AI recommendation engines use room context to surface complementary products ('items for your living room')
* Missing room data forces customers to scroll or abandon — incomplete data costs conversions
* Multi-room products (e.g. storage units) can hold multiple values — no need to duplicate listings

  ACF SETUP  

How to configure this field in Accentuate Custom Fields

| Where       | ACF dashboard → Templates tab → Product scope → Add new field |
| ----------- | ------------------------------------------------------------- |
| Label       | Room                                                          |
| Name / Key  | room                                                          |
| Namespace   | accentuate (default)                                          |
| Field type  | Shopify >> Single-line text (List)                            |
| Multi-value | Yes — a product can suit multiple rooms simultaneously        |

<br>

| Note: Use a List field, not a single text field. Filtering for 'living room AND bedroom' (e.g. a versatile storage unit) requires separate list entries per room. A single multi-line value cannot support this AND logic. |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

&#x20;&#x20;

STEP-BY-STEP IN ACF &#x20;

* Open ACF, go to Templates tab and select the Product scope
* Click 'Add new field'
* Label: 'Room' — Key auto-fills as 'room'
* Namespace: leave as 'accentuate'
* Field type: Shopify >> Single-line text (List)
* Enable 'Allow multiple selections' — many products suit multiple rooms
* Click Done, then Save
* Open any home product and populate with the relevant room values

| Shopify admin (optional pinning): Settings → Custom data → Products. Namespace: 'accentuate', Key: 'room', Type: Single-line text (List). Pin this field — room is one of the most frequently populated attributes and should be accessible without opening ACF. |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

&#x20; REFERENCE VALUES &#x20;

Example values — adapt to your catalogue

| Value         | When to use                                                                    |
| ------------- | ------------------------------------------------------------------------------ |
| Living room   | Sofas, coffee tables, rugs, lighting, decorative objects, media units          |
| Bedroom       | Beds, bedside tables, wardrobes, bedding, sleep lighting, bedroom mirrors      |
| Kitchen       | Kitchen storage, utensil holders, small appliances, kitchen textiles           |
| Dining room   | Dining tables, chairs, sideboards, table linen, dinnerware storage             |
| Bathroom      | Towels, bath mats, vanity accessories, shelving, mirrors, laundry bins         |
| Home office   | Desks, office chairs, shelving, desk accessories, task lighting                |
| Hallway       | Coat racks, shoe storage, console tables, hall mirrors, doormats               |
| Nursery       | Cots, changing units, storage, soft furnishings for children's spaces          |
| Outdoor patio | Outdoor furniture, weatherproof rugs, garden lighting, planters                |
| Balcony       | Compact outdoor furniture, balcony planters, weather-resistant storage         |
| Garden        | Garden furniture sets, garden storage, outdoor structures, decking accessories |
| Multi-room    | Versatile pieces with no single primary room (e.g. universal storage cubes)    |

&#x20;&#x20;

<br>

BEST PRACTICES &#x20;

* Assign the room where the product will primarily be used, not every possible room it could fit
* Use 'Multi-room' only when the product genuinely has no primary room context
* Be consistent with room naming across your catalogue — 'Living room' not 'Lounge' or 'Sitting room'
* Align room values with the room categories used in your navigation and collection pages
* Review room values when a product is repositioned or rebranded for a different use case

&#x20; COMMON MISTAKES &#x20;

* Assigning every possible room to avoid missing a sale — this dilutes filtering precision and frustrates customers
* Using inconsistent naming: 'Lounge', 'Living room', and 'Sitting room' are the same room — pick one
* Skipping room on outdoor products — 'Outdoor patio', 'Balcony', and 'Garden' are distinct and matter for filtering
* Not updating room when a product's positioning changes (e.g. a desk repurposed for a children's bedroom)

&#x20;&#x20;

\
\
\
\
\ <br>

IN CONTEXT &#x20;

| Linen Storage Ottoman — Natural Oak Legs | <p><br></p>              |
| ---------------------------------------- | ------------------------ |
| Room                                     | Living room, Bedroom     |
| Style                                    | Scandinavian, Minimalist |
| Material                                 | Linen fabric, Solid oak  |
| Function                                 | Storage, Seating         |

&#x20;

\ <br>

&#x20;DEVELOPER IMPLEMENTATION &#x20;

| Liquid note: Shopify >> List — use .value for the array. Render room badges prominently on the product page and use them to power 'Shop the Room' collection logic. |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

<br>

Liquid — Storefront Rendering

\| <p>{% comment %}</p><p>Room — Shopify >> Single-line text (List)</p><p>Namespace: accentuate | Key: room</p><p>Use for collection filtering and 'Shop the Room' features</p><p>{% endcomment %}</p><p>{% assign rooms = product.metafields.accentuate.room.value %}</p><p>{% if rooms != blank %}</p><p>  \<div class="room-tags"></p><p>    {% for room in rooms %}</p><p>      \<span class="room-badge">{{ room }}\</span></p><p>    {% endfor %}</p><p>  \</div></p><p>{% endif %}</p> |
\| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

<br>

| Pro tip: Use room values to build automated collection pages via Shopify collection conditions. A 'Living Room' collection filtered by room = 'Living room' populates itself automatically as you add products — zero manual curation required. |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

&#x20;&#x20;

SEE ALSO &#x20;

* Style — the aesthetic language that describes how a product looks within a room
* Indoor / Outdoor — determines environmental suitability before room assignment
* Function — what the product does within the room context

| Full ACF documentation: help.accentuate.io \| Metafield Definitions → Fields → Field data type → Shopify field types |
| -------------------------------------------------------------------------------------------------------------------- |

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.accentuate.io/use-case-guides/home-and-living/room.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.