워드프레스 어드민 툴바가 프런트엔드에 안 보일 때 확인할 설정과 해결 순서

워드프레스에 로그인한 상태에서 사이트를 방문하면 보통 화면 상단에 관리자 도구 표시줄, 즉 어드민 툴바가 나타납니다. 글 수정, 테마 사용자 정의, 플러그인 관리 화면으로 바로 이동할 수 있어 편리한 기능입니다.

그런데 관리자 페이지에서는 툴바가 정상적으로 보이는데 프런트엔드에서만 사라지는 경우가 있습니다. 이때는 워드프레스 자체의 오류라기보다 사용자별 표시 설정, 테마나 플러그인의 필터, 사이트 URL, 캐시가 원인일 가능성이 큽니다.

이럴 때는	먼저 볼 곳
특정 계정에서만 안 보인다	사용자 프로필의 도구 모음 표시 옵션
모든 계정에서 안 보인다	show_admin_bar 필터가 걸린 코드
기본 테마로 바꾸면 보인다	테마·차일드 테마의 헤더 출력
시크릿 창에서는 보인다	브라우저 캐시와 확장 프로그램
로그아웃 상태와 화면이 같다	로그인 사용자까지 저장하는 페이지 캐시

아래 순서대로 확인하면 불필요하게 모든 설정을 한꺼번에 바꾸지 않고 원인을 좁힐 수 있습니다.

먼저 사용자 프로필에서 툴바 표시를 확인하세요

가장 먼저 확인할 곳은 현재 로그인한 사용자의 프로필입니다. 워드프레스 관리자 화면에서 사용자 » 프로필로 이동한 뒤 도구 모음 또는 사이트를 볼 때 도구 모음 표시 항목을 찾습니다.

이 옵션이 해제되어 있으면 관리자 화면의 일부 기능은 사용할 수 있어도 사이트를 보는 프런트엔드에서는 상단 툴바가 표시되지 않습니다. 체크한 다음 페이지 아래쪽의 프로필 업데이트 버튼을 누르고, 프런트엔드 페이지를 새로 고침합니다.

브라우저에 이전 화면이 남아 있을 수 있으므로 일반 새로 고침으로 변화가 없으면 강력 새로 고침을 시도하는 것도 좋습니다. 다른 관리자 계정에서는 툴바가 보이는데 특정 계정에서만 보이지 않는다면 이 사용자 프로필 설정이 원인일 가능성이 특히 높습니다.

테마와 코드에서 어드민 툴바를 숨기는지 점검

프로필 설정이 정상인데도 표시되지 않는다면 테마 또는 차일드 테마의 functions.php 파일을 확인해야 합니다. 워드프레스에서는 show_admin_bar 필터를 이용해 관리자 툴바를 전체적으로 끌 수 있습니다.

add_filter( 'show_admin_bar', '__return_false' );

이 코드가 들어 있으면 로그인 여부와 관계없이 어드민 툴바가 숨겨집니다. 직접 추가한 코드가 아니라 테마 설정이나 기능 플러그인에 포함되어 있을 수도 있습니다. 발견했다면 삭제하거나, 사이트 운영 목적에 맞게 조건을 제한해야 합니다.

예를 들어 로그인한 사용자에게만 툴바를 표시하려면 다음과 같은 방식으로 처리할 수 있습니다.

add_filter( 'show_admin_bar', function( $show ) {
    return is_user_logged_in() ? true : $show;
}, 9999 );

다만 functions.php를 수정할 때는 차일드 테마를 사용하는 편이 안전합니다. 부모 테마를 직접 수정하면 테마 업데이트 때 변경 내용이 사라질 수 있습니다. 코드 수정 전에는 파일 백업을 남기고, 관리자 화면에 접근할 수 없게 될 상황에 대비해 FTP나 호스팅 파일 관리 기능으로 되돌릴 방법도 마련해 두는 것이 좋습니다.

테마와 플러그인을 바꿔 원인을 분리하는 방법

어드민 툴바는 테마의 헤더 구조나 플러그인의 출력 제어 영향을 받을 수 있습니다. 원인을 확인할 때는 한 번에 여러 요소를 바꾸기보다 테스트 범위를 줄이는 방식이 효율적입니다.

기본 테마로 바꿔 보기

먼저 현재 테마를 워드프레스 공식 테마인 Twenty Twenty-Five와 같은 기본 테마로 임시 변경합니다. 기본 테마에서 툴바가 다시 나타난다면 기존 테마 또는 차일드 테마의 코드, 헤더 출력, 스타일 처리 중 하나가 문제일 수 있습니다.

플러그인을 하나씩 되살리기

테마를 바꿔도 동일하다면 모든 플러그인을 잠시 비활성화해 봅니다. 문제가 사라지면 플러그인을 하나씩 다시 활성화하면서 어느 플러그인이 증상을 재현하는지 찾습니다. 캐시, 보안, 페이지 빌더, 관리자 기능을 추가하는 플러그인은 우선 점검 대상입니다.

이 테스트는 실제 방문자에게 영향을 줄 수 있으므로 가능하면 작업이 적은 시간에 진행하거나 스테이징 사이트에서 수행하세요. 페이지 빌더를 사용 중인 사이트라면 플러그인을 비활성화하는 동안 레이아웃이나 캐시가 달라질 수 있으므로 테스트가 끝난 뒤 원래 설정을 다시 확인해야 합니다.

워드프레스 주소와 사이트 주소가 일치하는지 확인

워드프레스의 URL 설정이 잘못되어도 관리자 기능이 프런트엔드에서 정상적으로 동작하지 않을 수 있습니다. 관리자 화면의 설정 » 일반에서 다음 두 항목을 확인합니다.

• 워드프레스 주소(URL)
• 사이트 주소(URL)

일반적인 설치에서는 두 주소가 동일합니다. 하지만 워드프레스 파일을 하위 폴더에 설치한 뒤 사이트 주소에서 하위 폴더를 제거하는 구성도 가능합니다. 이 경우에는 설치 방식에 맞는 설정이므로 무조건 두 주소를 같게 바꾸면 안 됩니다.

중요한 것은 http와 https, 도메인 앞뒤의 www, 하위 폴더 포함 여부가 실제 사이트 구조와 일치하는지입니다. 주소를 수정했다면 저장 후 캐시를 삭제하고, 로그아웃 상태와 로그인 상태에서 각각 사이트를 확인합니다. URL을 잘못 바꾸면 로그인 세션이 끊기거나 관리자 화면에 접근하지 못할 수 있으므로 변경 전 현재 값을 기록해 두는 편이 안전합니다.

캐시 플러그인과 로그인 사용자 캐시를 확인

로그인한 사용자에게는 일반 방문자와 다른 HTML이 제공되어야 합니다. 그런데 캐시 플러그인이 로그인 사용자의 페이지까지 저장하면, 툴바가 없는 이전 HTML이 계속 표시될 수 있습니다. 특히 페이지 캐시가 오래 남아 있거나 캐시 삭제 규칙이 제대로 적용되지 않은 경우 이런 현상이 발생합니다.

대부분의 캐시 플러그인은 로그인 사용자를 캐시에서 제외하는 설정을 제공합니다. 관리자, 편집자, 기여자, 작성자 등 로그인 역할이 캐시 대상에 포함되어 있지 않은지 확인하세요. Breeze를 사용하는 경우 로그인 사용자 캐시 관련 옵션에서 기본 워드프레스 역할이 캐시되지 않도록 설정하는 것이 중요합니다. 이 설정이 잘못되면 어드민 툴바뿐 아니라 Elementor 같은 페이지 빌더의 편집 화면에서도 예상하지 못한 동작이 나타날 수 있습니다.

설정을 바꾼 뒤에는 플러그인 캐시, 서버 캐시, CDN 캐시가 있다면 각각 비워야 합니다. 브라우저 캐시만 삭제하고 서버에 남아 있는 페이지 캐시를 그대로 두면 문제가 계속될 수 있습니다.

Cloudways의 Breeze에서는 Browser Cache를 다시 적용

Cloudways 환경에서 Breeze 플러그인을 사용하고 있고, 다른 점검으로도 해결되지 않는다면 설정 » Breeze » Basic Options로 이동해 Browser Cache 옵션을 확인해 볼 수 있습니다.

이 옵션을 잠시 비활성화한 뒤 저장하고, 일정 시간이 지난 후 다시 활성화합니다. 이 과정에서 캐시 관련 규칙이 다시 작성되면서 프런트엔드에 남아 있던 잘못된 처리나 이전 규칙이 정리될 수 있습니다. 실제 사례에서는 Breeze의 브라우저 캐시를 껐다가 다시 켜는 것만으로 관리자 툴바가 다시 표시된 경우가 있습니다.

브라우저 캐시는 HTML, CSS, JavaScript, 이미지 같은 리소스를 방문자의 로컬 저장소에 보관해 재방문 시 로딩 속도를 높이는 기능입니다. 속도와 서버 부하 측면에서는 유용하지만, 변경된 콘텐츠가 즉시 보이지 않거나 이전 규칙이 남는 문제가 생길 수 있습니다. 따라서 옵션을 다시 활성화한 뒤에도 강력 새로 고침과 Breeze 캐시 삭제를 함께 수행하는 것이 좋습니다.

점검 후에도 툴바가 안 보일 때의 확인 순서

마지막으로 브라우저 개발자 도구나 다른 브라우저에서 동일한 증상이 나타나는지 확인합니다. 특정 브라우저에서만 발생한다면 확장 프로그램, 쿠키, 로컬 캐시 문제일 수 있습니다. 시크릿 창에서 로그인해 테스트하면 브라우저 측 원인을 빠르게 분리할 수 있습니다.

반대로 모든 브라우저에서 동일하고 기본 테마와 플러그인 비활성화 상태에서도 문제가 남는다면 호스팅 캐시, CDN, 서버 설정 또는 워드프레스 파일의 수정 여부까지 범위를 넓혀야 합니다. 툴바가 단순히 CSS로 가려진 것인지, 서버가 툴바 HTML 자체를 출력하지 않는지도 구분해야 합니다.

확인 순서는 사용자 프로필의 표시 옵션, show_admin_bar 코드, 테마와 플러그인 충돌, 사이트 주소, 로그인 사용자 캐시, Breeze의 Browser Cache 순서가 무난합니다. 특히 Cloudways와 Breeze 조합에서는 캐시 설정을 변경한 뒤 실제 캐시가 비워졌는지까지 확인해야 하며, 툴바 문제만 보고 로그인 사용자 전체를 캐시 대상으로 설정하는 것은 피해야 합니다.