Resi V2: How to Create a New Content Block
How to create a brand new content block in Resi V2 — the first step before adding a new section to any property website.
Before You Start
Applies to: Resi V2 only.
Note: Creating a content block in Resi is only step one. To display it on the website, you also need to connect it in the YOOtheme Builder. See How to Connect a Content Block to the Website Builder (V2) →.
Step-by-Step: Create a Property-Specific Content Block
- Navigate to your property → Content → Content Blocks.
- Click Add New Content Block.
- Enter a name following the naming convention: page/section-name
⚠️ Consistent naming is critical for managing content across a large portfolio. Always follow an organized Page | Section pattern. - Fill in the content fields relevant to this block (title, body text, CTA link, image, etc.).
💡 You don't have to fill in everything — only enable the fields you intend to display on the website. - Toggle the block to Enabled.
- Click Create.
Step-by-Step: Create a Global Content Block
If this block will be used across multiple properties:
- Go to Global Content → Content Blocks.
- Click Add New Content Block.
- Follow steps 3–6 above.
- Scroll to the bottom and assign it to all relevant properties.
- Save.
💡 It's often easier to create the block at the property level first, test it, then promote it to global by attaching additional properties — rather than going global from the start.
What Comes Next
Once created, your block exists in Resi but isn't visible on the website yet. You need to:
- Refresh the website's data (via Clear Website Cache or the WordPress Resi Settings → Refresh Property Data)
- Open the YOOtheme Builder and map the block to a section on the page (advanced access users).
See: How to Connect a Content Block to the Website Builder (V2) →
Common Mistakes to Avoid
- Not following the naming convention — unclear names like "New Block 3" become impossible to manage at scale. Always use page/section-name.
- Enabling every field — only enable fields you're actually using. Leaving empty optional fields enabled can cause blank spaces on the website.
- Forgetting the second step — a block created in Resi won't appear on the website until it's connected in the Builder.
Troubleshooting
|
Problem |
Solution |
|
I created the block but it's not in the Builder's content block dropdown |
Refresh the site data first: go to the property → Clear Website Cache, or in WordPress go to Resi Settings → Refresh Property Data. Wait ~60 seconds. |
|
The block name doesn't match the convention |
You can rename it — click into the block and update the internal title field. |
Related Articles
- How to Connect a Content Block to the Website Builder (V2)
- Understanding Global vs. Property-Specific Content (V2)
- How to Partition a Global Content Block (V2)