---
id: css-object-position
title: "CSS object-position"
category: "Frontend"
status: "draft"
verification_status: "conceptual"
canonical_id: ""
aliases: ["object-position", "image positioning", "x/y image position", "object-fit position", "content box position"]
duplicate_of: ""
source_trust_level: "B"
confidence_score: 0.89
created_at: 2026-06-23
updated_at: 2026-06-23
review_reason: ""
merge_history: []
tags: ["css", "web", "frontend", "w3schools", "object-position", "images", "video"]
raw_sources: ["https://www.w3schools.com/css/css3_object-position.asp"]
applied_in: []
github_commit: ""
---

# [[CSS object-position]]

## 🎯 한 줄 통찰 (One-line insight)
The CSS `object-position` property is used together with `object-fit` to specify how an `<img>` or `<video>` should be positioned with x/y coordinates within its container. [S1]

## 🧠 핵심 개념 (Core concepts)
- **Purpose** — `object-position` positions an `<img>` or `<video>` with x/y coordinates within its container, used together with `object-fit`. [S1]
- **First value = x-axis, second value = y-axis.** [S1]
- **Value forms** — strings (`left`, `center`, `right`) or numbers (`px` or `%`). [S1]
- **Negative values** are permitted. [S1]

## 🧩 추출된 패턴 (Extracted patterns)
- **Reframe a cropped image** — when `object-fit: cover;` crops an image, use `object-position` to choose which part of the image stays visible. [S1]
- **x/y pair** — supply two values: the first shifts horizontally, the second shifts vertically. [S1]

## 📖 세부 내용 (Details)
**What it does** — The CSS `object-position` property is used together with the `object-fit` property to specify how an `<img>` or `<video>` should be positioned with x/y coordinates within its container. [S1]

The first value controls the x-axis and the second value controls the y-axis. Values can be strings (`left`, `center`, `right`) or numbers (`px` or `%`), and negative values are allowed. [S1]

**Example 1 — position to center a building** [S1]
```css
.image-container {
  width: 200px;
  height: 300px;
  border: 1px solid black;
}

.image-container img {
  width: 100%;
  height: 100%;
  object-fit: cover;
  object-position: 80% 100%;
}
```

**Example 2 — reposition to center the Eiffel Tower** [S1]
```css
.image-container {
  width: 200px;
  height: 300px;
  border: 1px solid black;
}

.image-container img {
  width: 100%;
  height: 100%;
  object-fit: cover;
  object-position: 15% 100%;
}
```

**Related properties** [S1]

| Property | Description |
|---|---|
| `object-fit` | Specifies how an `<img>` or `<video>` should be resized to fit its container |
| `object-position` | Specifies how an `<img>` or `<video>` should be positioned with x/y coordinates inside its "own content box" |

## 🛠️ 적용 사례 (Applied in summary)
The page's own examples are the applied cases: a cropped (`object-fit: cover`) image re-framed via `object-position: 80% 100%` and `object-position: 15% 100%` to keep different subjects in view. No external project/commit applications found in the source.

## 💻 코드 패턴 (Code patterns)
Re-frame a cover-cropped image with x/y coordinates (language: CSS):
```css
.image-container img {
  width: 100%;
  height: 100%;
  object-fit: cover;
  object-position: 80% 100%;
}
```

## ⚖️ 모순 및 업데이트 (Contradictions & updates)
No contradictions found in the source.

## ✅ 검증 상태 및 신뢰도
- **상태:** draft
- **검증 단계:** conceptual (실제 적용 사례 발견 시 applied/validated로 승격 가능)
- **출처 신뢰도:** B (W3Schools — widely used educational reference, not a primary standards body)
- **신뢰 점수:** 0.89
- **중복 검사 결과:** 신규 생성 (New discovery)

## 🔗 지식 그래프 (Knowledge Graph)
- **상위/루트:** [[CSS Tutorial]]
- **관련 개념:** [[CSS Object Fit]], [[CSS Image Shapes]], [[CSS Images]]
- **참조 맥락:** Referenced when an `object-fit: cover` crop hides the important subject and must be re-framed.

## 📚 출처 (Sources)
- [S1] W3Schools — CSS object-position — https://www.w3schools.com/css/css3_object-position.asp

## 📝 변경 이력 (Change history)
- 2026-06-23: Initial draft synthesized from the W3Schools "CSS object-position" page (Astra wiki-curation, P-Reinforce v3.1 format).
