워드프레스 자식 테마 만들기 – 초보자도 10분이면 완성
✅ 핵심 답변
워드프레스 자식 테마 만들기: style.css와 functions.php 두 파일만 있으면 되며, style.css의 Template 값을 부모 테마 폴더명과 정확히 일치시켜야 워드프레스가 자식 테마로 인식합니다.
자식 테마는 파일 2개로 시작합니다. 워드프레스 공식 문서 기준, 자식 테마에 반드시 필요한 파일은 style.css 하나뿐이며 functions.php는 선택사항입니다. 하지만 커스텀 코드를 안전하게 관리하려면 두 파일 모두 생성하는 것이 표준 방식입니다.
이 글에서는 WP File Manager 플러그인을 기준으로 폴더 생성부터 파일 작성, 부모 테마 파일 복사까지 전 과정을 단계별로 안내합니다. 총 소요 시간은 10분 내외입니다.
📅 최종 업데이트: 2026년 04월 | ✍️ 정보 출처: WordPress 공식 문서 기준
1. 자식 테마란 무엇인가?
부모 테마를 보호하는 별도 작업 공간
워드프레스 자식 테마란 부모 테마의 기능과 디자인을 그대로 상속받으면서, 내 수정 코드는 별도 폴더에 보관하는 공식 개발 방식입니다. 부모 테마에 파일이 없으면 자식 파일을, 자식에 파일이 없으면 부모 파일을 자동으로 사용하는 구조입니다.(출처: WordPress 공식 문서)
- 부모 테마 업데이트 후에도 자식 테마 파일은 절대 덮어씌워지지 않음
- 자식 폴더에 없는 파일은 워드프레스가 자동으로 부모 것을 불러옴
- functions.php만 예외적으로 부모·자식 둘 다 동시에 실행됨
2. 준비물 및 사전 확인
시작 전 꼭 확인하세요
자식 테마를 만들기 전에 아래 두 가지를 반드시 확인해야 합니다. 부모 테마 폴더명은 style.css 작성 시 Template 값으로 사용되므로 정확히 알아야 합니다. WP File Manager가 없으면 새 폴더를 만들 수 없으므로 플러그인 설치가 선행되어야 합니다.
- WP File Manager 플러그인 설치·활성화 확인
- 부모 테마 폴더명 확인 (예: generatepress, astra, twentytwentyfour)
- 추가CSS 내용 메모장에 미리 백업 (자식 테마 전환 시 초기화됨)
✅ 시작 전 체크리스트 (DO / DON’T)
| ✅ 해야 할 것 (DO) | ❌ 하면 안 되는 것 (DON’T) |
|---|---|
| 추가CSS 내용 메모장에 백업 | 추가CSS 백업 없이 바로 전환 |
| 부모 테마 폴더명 정확히 확인 | 폴더명을 대충 기억으로 입력 |
| 파일은 복사(Copy)로 이전 | 파일을 이동(Move)으로 이전 |
| 수정한 PHP 파일만 선택 복사 | inc·assets 폴더 통째로 복사 |
| 시크릿 창으로 사이트 최종 확인 | 일반 창에서만 확인(캐시 오류) |
| WP_DEBUG로 오류 원인 파악 | 오류 메시지 무시하고 재시도 |
3. 자식 테마 폴더 및 파일 생성
3단계로 완성하는 파일 생성
WP File Manager → wp-content/themes/ 폴더로 이동 → 빈 공간 우클릭 → 새 폴더 만들기 → 원하는 폴더명 입력. 이후 해당 폴더 안에서 style.css와 functions.php를 각각 새 파일로 생성합니다. 폴더명은 영문 소문자와 하이픈(-)만 사용하면 자유롭게 정할 수 있습니다.
- style.css 필수 내용: Theme Name, Template(부모 폴더명) 두 줄이 핵심
- functions.php 필수 내용: enqueue 코드로 부모 CSS 로드 선언
- 폴더명 규칙: 영문 소문자, 숫자, 하이픈(-)만 허용. 공백 금지
📄 style.css 작성 예시
/* Theme Name: 내 자식 테마 Template: generatepress Version: 1.0 */
⚠️ Template 값은 부모 테마 폴더명과 대소문자까지 정확히 일치해야 합니다.
📄 functions.php 작성 예시
<?php
// 자식 테마 스타일 로드
add_action('wp_enqueue_scripts', 'gp_child_enqueue_styles');
function gp_child_enqueue_styles(){
wp_enqueue_style(
'child-style',
get_stylesheet_directory_uri() . '/style.css',
array('generate-style')
);
}
// 여기 아래에 커스텀 코드 추가
4. 수정된 PHP 파일 복사하기
수정한 파일만 선택해서 복사
WP File Manager에서 부모 테마 폴더를 열고 수정 날짜(Modified) 기준으로 정렬하면 직접 수정한 파일을 쉽게 찾을 수 있습니다. 찾은 파일을 선택 후 우클릭 → 복사(Copy) → 자식 테마 폴더에 붙여넣기(Paste)로 진행합니다. 반드시 이동이 아닌 복사로 해야 부모 파일이 보존됩니다.
- 복사 대상: 수정 날짜가 최근인 PHP 파일들 (header.php, footer.php, single.php 등)
- 복사 금지: inc 폴더, assets 폴더, functions.php(별도 처리), style.css(이미 생성됨)
- 복사 후: 자식 폴더에서 해당 파일이 정상적으로 보이는지 확인
5. 자식 테마 만들기 최종 체크리스트
완료 전 이 항목을 모두 확인하세요
자식 테마 폴더와 파일 생성이 끝났다면 아래 체크리스트로 최종 점검합니다. 모든 항목이 완료되어야 안전하게 활성화할 수 있습니다. 추가CSS 복원을 가장 많이 놓치므로 특히 주의하세요.
- ✅ 자식 테마 폴더 생성 완료
- ✅ style.css 작성 완료 (Template 값 부모 폴더명 일치 확인)
- ✅ functions.php 작성 완료 (enqueue 코드 + 커스텀 코드)
- ✅ 수정된 PHP 파일 복사 완료 (이동 아닌 복사 확인)
- ✅ 부모 functions.php 원본 복원 완료
- ✅ 추가CSS 백업본 준비 완료
결론
워드프레스 자식 테마 생성의 핵심은 style.css의 Template 값을 부모 테마 폴더명과 정확히 일치시키는 것입니다. style.css와 functions.php 두 파일만 올바르게 작성하면 워드프레스가 자동으로 자식 테마를 인식하며, 이후 모든 커스터마이징은 자식 폴더에서만 진행하면 됩니다.
수정된 PHP 파일은 반드시 이동이 아닌 복사로 자식 폴더에 옮기고, inc·assets 폴더는 복사하지 않아야 합니다. 추가CSS 백업은 활성화 전 가장 먼저 해야 할 작업임을 기억하세요.
— 워드프레스 테마 개발 전문가 관점
📚 기초
Q1. 자식 테마를 만들 때 반드시 필요한 파일은 무엇인가요?
WordPress 공식 문서 기준 style.css 하나만 필수입니다. 단 커스텀 코드 관리를 위해 functions.php도 함께 생성하는 것이 표준 방식입니다.
Q2. 자식 테마 폴더명은 어떻게 정해야 하나요?
영문 소문자와 하이픈(-)만 사용하면 자유롭게 정할 수 있습니다. 부모 테마 폴더명과 달라도 됩니다. style.css의 Template 값만 부모 폴더명과 일치하면 됩니다.
Q3. FTP 없이 자식 테마를 만들 수 있나요?
네. WP File Manager 플러그인을 설치하면 워드프레스 대시보드에서 폴더 생성과 파일 편집이 모두 가능합니다.
Q4. style.css에 Template 값을 잘못 입력하면 어떻게 되나요?
워드프레스가 자식 테마를 인식하지 못하거나 활성화 시 흰 화면이 발생합니다. 반드시 파일 매니저에서 부모 테마 폴더명을 직접 확인 후 입력하세요.
Q5. 자식 테마에 파일이 없으면 어떻게 되나요?
워드프레스가 자동으로 부모 테마의 같은 이름 파일을 사용합니다. 수정하지 않은 파일은 자식 폴더에 복사할 필요가 없습니다.
⚠️ 주의사항
Q6. inc 폴더를 자식 테마에 복사하면 왜 안 되나요?
부모 functions.php가 inc 폴더를 직접 경로로 강제 로드합니다. 자식에도 같은 폴더가 있으면 두 번 실행되어 함수 중복 충돌이 발생합니다.
Q7. assets 폴더를 자식에 복사하면 CSS가 적용되나요?
적용되지 않습니다. GeneratePress는 부모 테마 경로를 직접 지정해 CSS를 로드하므로 자식 폴더에 같은 파일이 있어도 무시됩니다.
Q8. 파일을 복사가 아닌 이동으로 옮기면 어떻게 되나요?
부모 테마 폴더에서 파일이 사라져 워드프레스 구조가 불완전해집니다. 반드시 복사(Copy)로 진행해야 합니다.
Q9. 자식 테마 활성화 후 추가CSS가 비어있는 이유는 무엇인가요?
추가CSS는 테마별로 데이터베이스에 따로 저장됩니다. 부모 테마의 추가CSS는 자식 테마로 전환 시 자동으로 복사되지 않으므로 사전 백업 후 직접 붙여넣어야 합니다.
Q10. 자식 테마를 만든 후 부모 테마를 삭제해도 되나요?
절대 안 됩니다. 자식 테마는 부모 테마의 파일을 참조해서 실행됩니다. 부모 테마가 없으면 자식 테마도 정상 작동하지 않습니다.