How to Fix “does not name a type” in C++

Short answer: the compiler reached a name where it expected a type (like int, std::string or one of your classes), and that name isn’t a type it knows at that point in the file. Nine times out of ten, the class is used before it’s declared, the code sits outside a function, or std:: or an #include is missing.

Why It Happens

C++ reads your file from top to bottom, once. When it meets a line like Player hero;, it needs to already know what Player is. If it doesn’t, the line can’t be a valid declaration, and the compiler reports that Player “does not name a type”.

Every cause below is a different way of using a name before the compiler knows it’s a type.

Cause 1: Using a Class Before It’s Declared

#include <iostream>

Player hero;   // Player hasn't been declared yet

class Player {
public:
    int health = 100;
};

int main() {
    std::cout << hero.health << '\n';
}

GCC:    error: 'Player' does not name a type
Clang:  error: unknown type name 'Player'
MSVC:   error C4430: missing type specifier - int assumed. Note: C++ does not support default-int

Fix: move the class above the code that uses it. In a bigger program, put the class in a header file and #include it at the top. See header files in C++.

Cause 2: A Statement Outside Any Function

This one surprises beginners because the name clearly is declared:

#include <iostream>

int score;
score = 10;   // a statement outside any function

int main() {
    std::cout << score << '\n';
}

GCC:    error: 'score' does not name a type
Clang:  error: a type specifier is required for all declarations

Outside a function you can only declare things. An assignment is a statement, and statements have to run inside a function. The compiler tries to read score = 10; as a new declaration, finds no type, and complains.

Fix: give the variable its value where you declare it — int score = 10; — or move the assignment into main.

Cause 3: A Missing std::

#include <iostream>
#include <string>

string name = "Sam";   // missing std::

int main() {
    std::cout << name << '\n';
}

GCC:    error: 'string' does not name a type; did you mean 'stdin'?
Clang:  error: unknown type name 'string'

GCC’s suggestion (stdin) is a red herring. string lives in the std namespace.

Fix: write std::string, or add using std::string; near the top. See using namespace std for the trade-offs.

Cause 4: A Missing #include

#include <iostream>

std::vector<int> scores;   // <vector> not included

int main() {
    std::cout << scores.size() << '\n';
}

GCC:    error: 'vector' in namespace 'std' does not name a template type

Fix: #include <vector> at the top.

Be careful: this exact file may compile on another compiler, because a header such as <iostream> sometimes happens to include <vector> behind the scenes. Clang on our test machine compiled it without complaint. Don’t rely on that. Include every header you use, so your code builds everywhere.

Cause 5: A Typo

#include <iostream>
#include <string>

std::strng name = "Sam";   // typo

int main() {
    std::cout << name << '\n';
}

GCC:    error: 'strng' in namespace 'std' does not name a type; did you mean 'string'?
Clang:  error: no type named 'strng' in namespace 'std'

Fix: correct the spelling. GCC’s “did you mean” is usually right for typos, unlike in Cause 3. Capitalisation counts too: player and Player are different names.

Cause 6: Two Classes That Use Each Other

#include <iostream>

class Team {
    Player captain;   // Player is defined further down
};

class Player {
public:
    int health = 100;
};

int main() {
    Team t;
}

GCC:    error: 'Player' does not name a type
Clang:  error: unknown type name 'Player'

If the classes don’t depend on each other both ways, just reorder them. If they do, use a forward declaration. It tells the compiler “Player is a class; details later”, which is enough for a pointer or reference:

#include <iostream>

class Player;   // forward declaration: "Player is a class"

class Team {
    Player* captain = nullptr;   // a pointer is fine with just the declaration
};

class Player {
public:
    int health = 100;
};

int main() {
    Team t;
    std::cout << "ok\n";
}

A forward declaration isn’t enough to store a Player by value, because the compiler needs the full definition to know how big it is. That’s when a pointer, a reference or a reordering is the answer.

Quick Reference

For other common messages, see C++ error messages explained.

Take Your C++ Further

Header-file and linker errors stop being mysterious once you know how your .cpp files become a program. C++ Better Explained explains how C++ code gets compiled, step by step, in plain English with diagrams.

Get the book — $19

87 pages · plain English · 30-day money-back guarantee

Related Articles

• C++ Error Messages Explained — the most common errors and what they mean.
• How to Fix ‘was not declared in this scope’ — the same problem for variables and functions.
• Header Files in C++ — sharing classes between files.
• using namespace std in C++ — the missing-std:: problem in depth.
• C++ Classes and Objects — how classes are declared and used.