✅ 핵심 답변
워드프레스 자식 테마란 부모 테마를 직접 수정하지 않고 별도 폴더에서 커스터마이징하는 방법으로, 테마 업데이트 후에도 내 수정 코드가 영구 보존되는 안전한 공식 개발 방식입니다.
자식 테마 생성부터 오류 해결까지 모든 정보를 한곳에 모았습니다.
워드프레스 테마를 직접 수정하면 테마 업데이트 시 모든 변경사항이 초기화됩니다. 자식 테마는 이 문제를 근본적으로 해결하는 공식 방법으로, 부모 테마 파일은 건드리지 않고 자식 테마 폴더에서만 작업합니다.
이 페이지에서는 자식 테마 폴더 생성, style.css와 functions.php 설정, 커스텀 코드 이전, CSS 적용, 그리고 흰 화면 등 오류 해결까지 단계별로 안내합니다.
📅 최종 업데이트: 2026년 04월 | ✍️ 정보 출처: WordPress 공식 문서 기준
자식 테마는 style.css와 functions.php 단 2개 파일로 시작합니다. WP File Manager 플러그인으로 themes 폴더 안에 새 폴더를 만들고, style.css에 Template: 부모테마폴더명을 입력하면 워드프레스가 자동으로 자식 테마를 인식합니다.
폴더명은 영문 소문자와 하이픈(-)만 사용하며 자유롭게 정할 수 있습니다. 파일 복사 시 반드시 이동이 아닌 복사로 진행해야 부모 파일이 보존됩니다.
→ 단계별 생성 가이드 보기파일 준비가 끝나면 대시보드 → 외모 → 테마에서 자식 테마 카드를 확인하고 활성화 버튼을 클릭합니다. 활성화 전 추가CSS 백업이 가장 중요한 사전 작업입니다.
활성화 후에는 반드시 시크릿 창으로 사이트를 확인하세요. 일반 창은 브라우저 캐시로 인해 깨진 것처럼 보일 수 있습니다.
→ 활성화 체크리스트 확인하기부모 테마 functions.php에 추가했던 커스텀 코드를 자식 테마로 이전할 때 GeneratePress 원본 코드는 절대 복사하면 안 됩니다. 커스텀 코드만 자식 functions.php 맨 아래에 붙여넣고 부모에서는 해당 코드를 삭제해야 충돌이 방지됩니다.
이전 완료 후 부모 functions.php 마지막 줄이 require 구문으로 끝나면 정상입니다.
→ 안전한 코드 이전 방법 보기자식 테마 CSS는 자식 style.css 또는 추가CSS(사용자 정의하기) 두 곳에만 작성해야 합니다. assets/css 폴더를 직접 수정하면 업데이트 시 사라지고, 자식 폴더에 복사해도 부모 것이 우선 로드됩니다.
CSS 우선순위는 부모 CSS → 자식 style.css → 추가CSS 순서로 나중에 로드될수록 높습니다.
→ CSS 우선순위 완벽 이해하기자식 테마 활성화 후 흰 화면이 나오면 파일 매니저에서 자식 폴더명을 임시로 변경하면 즉시 복구됩니다. CSS 깨짐은 대부분 추가CSS 미복원 또는 enqueue 코드 문제입니다.
WP_DEBUG를 활성화하면 정확한 오류 위치와 원인을 빨간 메시지로 확인할 수 있습니다.
→ 오류 유형별 해결법 보기Q1. 자식 테마를 만들지 않고 부모 테마를 직접 수정하면 어떻게 되나요?
테마 업데이트 시 수정한 모든 내용이 초기화됩니다. 자식 테마를 사용하면 업데이트 후에도 커스터마이징이 영구 보존됩니다.
Q2. 자식 테마 폴더명은 반드시 정해진 이름을 써야 하나요?
아닙니다. 폴더명은 자유롭게 정할 수 있습니다. 단 style.css의 Template: 값이 부모 테마 폴더명과 정확히 일치해야 합니다.
Q3. 자식 테마로 전환하면 기존 디자인이 바뀌나요?
올바르게 설정하면 디자인 변화가 없습니다. 단 추가CSS는 테마별로 저장되므로 반드시 사전 백업 후 자식 테마에서 다시 붙여넣어야 합니다.
Q4. inc 폴더와 assets 폴더도 자식 테마에 복사해야 하나요?
복사하면 안 됩니다. inc 폴더는 부모 functions.php가 직접 경로를 지정해 로드하므로 충돌이 발생하고, assets 폴더는 복사해도 적용되지 않습니다.
Q5. 자식 테마 활성화 후 흰 화면이 나오면 어떻게 하나요?
파일 매니저에서 자식 테마 폴더명을 임시로 변경하면 즉시 복구됩니다. 이후 WP_DEBUG로 정확한 오류 원인을 확인하세요.